keshro 0.1.26

High-stakes engineering project execution for AI coding agents

Keshro

Plan and run high-stakes engineering projects with AI agents.

keshro login              # authenticate and install Claude Code + Codex integrations
keshro create             # scan project, create the right migration/project
keshro continue           # agents execute in parallel if possible

keshro login authenticates the CLI and installs agent integrations on the current machine. For Codex, Keshro adds a managed block to ~/.codex/AGENTS.md and preserves any non-Keshro content already in that file.

Keshro is built for migrations first. It scans the repo, asks the follow-up questions that actually matter for the migration, creates the right migration or project, then coordinates agents to execute it safely.

Works with your existing coding agent. Use Claude Code or Codex for planning, migration intake, and parallel execution.

Examples:

• AWS Batch -> Airflow
• Terraform -> Pulumi
• Jenkins -> GitHub Actions
• Express -> Fastify
• Apache Iceberg -> ClickHouse

What Keshro does:

1. Builds a migration-aware execution context with risks, open questions, task ordering, and acceptance criteria
2. Runs agents in parallel in isolated git worktrees
3. Detects live file overlap in Codex worktrees, pauses the lagging agent, and resumes after rebasing onto the winning task's changes
4. Carries learnings from one task into related future tasks
5. Tracks progress, decisions, rollback points, and live per-agent telemetry through execution

Create a migration or project

keshro create

Keshro scans the project, detects whether this is a migration, asks the follow-up questions that matter, and creates the right migration or project with a linked execution context.

If Keshro stops to ask follow-up questions in /keshro or another agent session, surface those questions back to the user and resume with the generated --answers-file command instead of building a giant shell command by hand.

Execute

Keshro drives the full execution loop — picks up the next task, gives the agent context, validates the result, marks it done, and moves to the next one. You don't manage it.

keshro continue

By default, keshro continue runs the next ready wave in parallel when the environment supports it. Each launched agent gets its own session ID and heartbeats live status back to Keshro, including touched files, progress messages, recent errors, and mid-task conflict detection. Use --no-parallel only when you explicitly want one task at a time.

Monitor

keshro status

Works with

Planning, execution, and parallel mode work with Claude Code and Codex. Both agents run in isolated git worktrees during parallel mode. If one agent is rate-limited, Keshro suggests switching and supports a saved default via keshro config set --agent ....

Cursor is supported for in-editor context via .cursorrules (keshro setup-cursor), but does not have a headless CLI, so it cannot be used as an execution agent.

Keshro can also create general projects from repos, issues, and freeform descriptions, but the primary workflow is migrations.

License

MIT