https://github.com/alo-exp/sidekick
Claude Code plugin — Forge and Kay delegation modes, 3-level fallback ladder, AGENTS.md mentoring, auto-install via OpenRouter
https://github.com/alo-exp/sidekick
claude-code coding-agent forge forgecode openrouter orchestration sidekick terminal-agent
Last synced: 11 days ago
JSON representation
Claude Code plugin — Forge and Kay delegation modes, 3-level fallback ladder, AGENTS.md mentoring, auto-install via OpenRouter
- Host: GitHub
- URL: https://github.com/alo-exp/sidekick
- Owner: alo-exp
- Created: 2026-04-10T10:06:06.000Z (2 months ago)
- Default Branch: main
- Last Pushed: 2026-06-11T23:02:23.000Z (11 days ago)
- Last Synced: 2026-06-12T00:14:05.015Z (11 days ago)
- Topics: claude-code, coding-agent, forge, forgecode, openrouter, orchestration, sidekick, terminal-agent
- Language: Shell
- Homepage: https://sidekick.alolabs.dev
- Size: 4.99 MB
- Stars: 2
- Watchers: 0
- Forks: 0
- Open Issues: 5
-
Metadata Files:
- Readme: README.md
- Changelog: CHANGELOG.md
- Agents: AGENTS.md
Awesome Lists containing this project
README
# Sidekick
**AI coding-agent delegation for Claude Code and Codex.** Sidekick lets the host AI stay focused on planning, review, mentoring, and communication while supported sidekicks perform implementation work.
## Supported Sidekicks
| Sidekick | Activate | Runtime |
| --- | --- | --- |
| **Kay** | `/sidekick:kay-delegate` | Kay runtime installed and repaired through Sidekick |
| **Codex** | `/sidekick:codex-delegate` | Local OpenAI Codex CLI, using `gpt-5.4-mini` with extra-high reasoning |
Kay defaults to the existing `opencode-go` routing. Activate Kay with `/sidekick:kay-delegate xiaomi` to use Xiaomi routing, or `/sidekick:kay-delegate ocg` to force OpenCode Go routing for the session. `SIDEKICK_KAY_PROVIDER` remains supported as an environment override. Sidekick selects the model automatically per provider.
Stop commands:
| Sidekick | Stop |
| --- | --- |
| Kay | `/sidekick:kay-stop` |
| Codex | `/sidekick:codex-stop` |
## How It Works
```text
Host AI = Brain
Sidekick = Hands
```
The host AI creates the plan, delegates bounded implementation tasks, reviews the sidekick output, and verifies the final state before reporting completion. Sidekick hooks prevent direct host edits while a sidekick is active and route supported runtime commands through bounded, redacted progress surfaces.
## Host Verification
After every sidekick task, the host must verify the result against the original prompt and success criteria. If the sidekick missed a requirement, broke integration, introduced a regression, used wrong logic, changed the wrong file, hit a syntax error, relied on a bad assumption, misunderstood the task, stopped early, or was blocked by provider or environment failures, the host relaunches the active sidekick with focused guidance until the failure is resolved.
## Testing
```bash
bash tests/run_unit.bash
bash tests/run_all.bash
bash tests/run_in_kay.bash SIDEKICK_LIVE_CODEX=1 bash tests/run_release.bash
```