Sisyphus for Kiro CLI

A discipline agent system for Kiro CLI. Drop this into any project and get an orchestrated team of 8 AI agents that plan, delegate, implement, and verify code.

What You Get

Sisyphus is the main orchestrator. It classifies your intent, creates a plan, delegates to specialist agents, and doesn't stop until everything is done.

| Agent | What it does | |-------|-------------| | sisyphus | Orchestrates everything. Plans with todos, delegates to specialists, verifies results. | | hephaestus | Autonomous deep worker. Give it a goal, it explores the codebase and implements end-to-end. | | oracle | Strategic advisor. Architecture decisions, hard debugging, post-implementation review. Read-only. | | explore | Codebase search. "Where is X?", "Find the code that does Y". Fire multiple in parallel. | | librarian | Docs research. Searches web, official docs, and GitHub via MCP tools. | | quick | Fast single-file changes. Typos, config tweaks, small fixes. | | visual-engineering | Frontend/UI specialist. Components, styling, animations. Design-first approach. | | ultrabrain | Hard logic. Complex algorithms, type puzzles, performance optimization, deep debugging. |

Install

Quick install (npx)

# Install into current project
cd your-project
npx sisyphus-kiro

# Or install globally (available in all projects)
npx sisyphus-kiro --global

# Run setup (one-time, enables experimental features)
./setup-kiro.sh

# Start
kiro-cli chat

Manual install

git clone https://github.com/perezjoseph/sisyphus-kiro.git .sisyphus-tmp
cp -r .sisyphus-tmp/.kiro .kiro
cp .sisyphus-tmp/setup-kiro.sh .
rm -rf .sisyphus-tmp
./setup-kiro.sh

What setup-kiro.sh Does

Enables Kiro CLI experimental features and sets Sisyphus as default:

• chat.enableTodoList — Todo tracking for multi-step tasks
• chat.enableThinking — Extended reasoning
• chat.enableKnowledge — Persistent knowledge base
• chat.enableCheckpoint — Workspace checkpoints
• chat.enableNotifications — Desktop notifications
• chat.enableTangentMode — Side conversations
• chat.defaultAgent "sisyphus" — Sisyphus as default

How It Works

1. You type a request
2. Sisyphus classifies your intent (research / implementation / fix / evaluation)
3. For non-trivial tasks, it creates a todo list
4. It delegates to specialist agents via the subagent tool
5. Specialists work autonomously (all are trusted, no permission prompts)
6. Sisyphus verifies the results
7. Repeats until all todos are complete

Example

> Add input validation to all API endpoints

I detect implementation intent — multi-file change across API layer.
My approach: explore codebase first, then delegate to hephaestus.

[Creates todo list with 4 items]
[Fires 2 explore subagents in parallel to find all endpoints and existing patterns]
[Delegates implementation to hephaestus with full context]
[Verifies with diagnostics]
[Marks todos complete]

Project Structure

.kiro/
├── agents/                    # 8 agent configs
│   ├── sisyphus.json          # Main orchestrator
│   ├── hephaestus.json        # Deep worker
│   ├── oracle.json            # Advisor
│   ├── explore.json           # Codebase search
│   ├── librarian.json         # Docs research
│   ├── quick.json             # Fast fixes
│   ├── visual-engineering.json # Frontend
│   ├── ultrabrain.json        # Hard logic
│   └── prompts/               # Agent system prompts
├── steering/                  # Persistent context
│   ├── product.md             # System overview
│   ├── conventions.md         # Code style rules
│   └── intent-gate.md         # Intent classification
├── skills/                    # Skill packages
│   ├── git-master/            # Git operations
│   ├── frontend-ui-ux/        # UI/UX design
│   ├── dev-browser/           # Browser automation
│   ├── playwright/            # Browser testing
│   ├── review-work/           # Post-implementation review
│   └── ai-slop-remover/       # Clean AI-generated code
├── hooks/                     # Lifecycle hooks
│   ├── comment-checker.sh     # Detects AI slop in comments
│   └── git-status.sh          # Git context on agent spawn
├── settings/
│   └── mcp.json               # MCP servers (Exa, Context7, grep_app)
└── AGENTS.md                  # System documentation

MCP Servers

Three remote MCP servers are pre-configured:

| Server | What | Used by | |--------|------|---------| | websearch (Exa) | Web search | librarian | | context7 | Library documentation | librarian, sisyphus | | grep_app | GitHub code search | librarian |

Customization

Add your own steering

Create .kiro/steering/your-project.md with project-specific context. It's automatically loaded.

Add skills

Create .kiro/skills/your-skill/SKILL.md with YAML frontmatter:

---
name: your-skill
description: When to activate this skill. Be specific.
---

# Your Skill Instructions
...

Change the default model

Edit .kiro/agents/sisyphus.json and set the model field.

Keyboard Shortcuts

• Ctrl+1 — Switch to Sisyphus
• Shift+Tab — Toggle plan mode
• /agent swap <name> — Switch to any agent

Credits

Inspired by the agent orchestration patterns from the open-source AI agent community.

License

MIT