https://github.com/team-attention/code-squad
Stay in flow while building with AI
https://github.com/team-attention/code-squad
ai claude code-review codex gemini vscode-extension
Last synced: 3 months ago
JSON representation
Stay in flow while building with AI
- Host: GitHub
- URL: https://github.com/team-attention/code-squad
- Owner: team-attention
- License: mit
- Created: 2025-11-27T05:30:45.000Z (7 months ago)
- Default Branch: main
- Last Pushed: 2026-02-14T08:53:54.000Z (4 months ago)
- Last Synced: 2026-02-14T16:46:05.496Z (4 months ago)
- Topics: ai, claude, code-review, codex, gemini, vscode-extension
- Language: TypeScript
- Homepage: https://marketplace.visualstudio.com/items?itemName=JakePark.code-squad
- Size: 2.47 MB
- Stars: 58
- Watchers: 0
- Forks: 6
- Open Issues: 5
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
**Tmux-powered worktree dashboard for multi-branch development.**
https://github.com/user-attachments/assets/cd1c6eb1-21fe-4179-91b8-a1abd920ea41
[](https://npmjs.com/package/code-squad-cli)
[](https://github.com/team-attention/code-squad)
[](LICENSE)
## Install
```bash
npm install -g code-squad-cli
```
## Quick Start
```bash
csq # Open tmux dashboard
```
**Dashboard controls:**
- `j/k` or `↑/↓` - Navigate worktree list
- `n` - Create new worktree
- `d` - Delete worktree
- `Enter` - Open worktree in new pane
- `q` - Quit (closes all panes)
- `Ctrl+b m` - Move/swap panes
## CLI Commands
```bash
csq # Open tmux dashboard (default)
csq new # Create worktree
csq list # List worktrees
csq quit # Delete current worktree
csq --legacy # Use old TUI mode
```
## Features
- **Tmux Dashboard** - Manage worktrees with keyboard shortcuts
- **Multi-pane Layout** - Work on multiple branches side-by-side
- **Auto tmux Install** - Installs tmux if missing (macOS/Linux)
- **File Sync** - Copy config files (`.env*`) to new worktrees
## Requirements
- Git
- tmux (auto-installed on first run)
## Config
Create `~/.code-squad/config.json`:
```json
{
"projects": {
"/path/to/project": {
"worktreeCopyPatterns": [".env*", "config/**"]
}
}
}
```
Or create `.code-squad.json` in your project root.
---
## VSCode Extension
For IDE users who prefer visual management.
### Install
Search "Code Squad" in Extensions or [Open VSX](https://open-vsx.org/extension/JakePark/code-squad)
### Features
- **Thread Management** - Multiple AI agents in isolated workspaces
- **Worktree Isolation** - Each thread gets its own git worktree
- **Diff View** - File-by-file or grouped by function/class
- **Inline Comments** - Select lines, comment, send to AI
- **Auto-Detect** - Detects claude, codex, gemini, opencode
### Settings
| Setting | Default | Description |
|---------|---------|-------------|
| `codeSquad.autoDetect` | `true` | Auto-detect AI tools |
| `codeSquad.autoShowPanel` | `true` | Open panel when AI detected |
| `codeSquad.worktreeCopyPatterns` | `[]` | Files to copy to worktree |
---
## Links
[GitHub](https://github.com/team-attention/code-squad) · [Issues](https://github.com/team-attention/code-squad/issues) · [npm](https://npmjs.com/package/code-squad-cli)
---
**MIT License**