This project addresses the need for a consolidated terminal-based development environment, integrating AI agents, Git, task management, and file browsing. It targets developers seeking to streamline their workflow by performing planning, coding, monitoring, and committing tasks without leaving the terminal. The primary benefit is enhanced productivity through reduced context switching.

How It Works

Sidecar consolidates the entire development workflow within a single terminal interface. It integrates AI agent interactions, Git operations, task management via TD, and file browsing. The core approach leverages a split-pane terminal setup, allowing users to monitor AI progress on one side while reviewing code or managing tasks on the other. This design aims to streamline the development loop—from planning and coding to reviewing and committing—without context switching to a graphical editor.

Quick Start & Requirements

• Primary Install:
  • macOS: brew install marcus/tap/sidecar
  • Linux / Other: curl -fsSL https://raw.githubusercontent.com/marcus/sidecar/main/scripts/setup.sh | bash
• Prerequisites: macOS, Linux, or WSL. Go 1.21+ (if building from source).
• Links: Documentation, Getting Started, Binary downloads, Manual install.

Highlighted Details

• Git Status Plugin: Comprehensive Git management including staging, diff viewing, and commit history browsing with auto-refresh.
• Conversations Plugin: Unified view and search across session histories from multiple AI coding agents (e.g., Claude Code, Gemini CLI).
• TD Monitor Integration: Real-time tracking of AI agent tasks, progress logging, and context maintenance across sessions.
• File Browser Plugin: Navigate project files with a collapsible tree view and syntax-highlighted code previews.
• Workspaces Plugin: Manage parallel development branches, link tasks, and launch agents with integrated merge workflows.
• Project & Worktree Switching: Seamlessly switch between configured projects and git worktrees, with state persistence.
• Theme Customization: Supports built-in themes and extensive community color schemes derived from iTerm2-Color-Schemes.

Maintenance & Community

The project is marked as 'Ready for daily use' with an invitation for bug reports via GitHub Issues. A 'Sidecar Roadmap' is referenced for planned features and backlog items. No specific community channels (e.g., Discord, Slack) or details on core contributors/sponsorships are provided in the README.

Licensing & Compatibility

MIT License. This license is permissive and generally compatible with commercial use and closed-source linking.

Limitations & Caveats

While marked 'Ready for daily use,' the project actively solicits issue reports, indicating ongoing development and refinement. No specific technical limitations, unsupported platforms, or known bugs are detailed in the README.