Skip to main content

High-stakes engineering project execution for AI coding agents

Project description

Keshro

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

pip install keshro
keshro login              # opens browser to authenticate
keshro create             # scan project, generate plan
keshro continue           # agents execute in parallel if possible

Keshro is built for migrations first. It scans the repo, asks the follow-up questions that actually matter for the migration, generates a migration-aware execution plan, 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 plan with risks, open questions, task ordering, and acceptance criteria
  2. Runs agents in parallel in isolated git worktrees
  3. Carries learnings from one task into related future tasks
  4. Tracks progress, decisions, and rollback points through execution

Create a migration

keshro create

Keshro scans the project, asks follow-up questions, and creates a migration with analysis, risks, open questions, and a linked execution plan.

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

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 execution plans from repos, issues, and freeform descriptions, but the primary workflow is migrations.

License

MIT

Project details


Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

keshro-0.1.12.tar.gz (96.6 kB view details)

Uploaded Source

Built Distribution

If you're not sure about the file name format, learn more about wheel file names.

keshro-0.1.12-py3-none-any.whl (76.9 kB view details)

Uploaded Python 3

File details

Details for the file keshro-0.1.12.tar.gz.

File metadata

  • Download URL: keshro-0.1.12.tar.gz
  • Upload date:
  • Size: 96.6 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? Yes
  • Uploaded via: twine/6.1.0 CPython/3.13.7

File hashes

Hashes for keshro-0.1.12.tar.gz
Algorithm Hash digest
SHA256 b7636838df55cd294368d3b91f62bde5886e3ff96e5c531f001c9cec070d2de6
MD5 4125d479d2eaa8ccf4b0c2288205fc5c
BLAKE2b-256 540b037394bfcb8858ef93dbd243f8313c4f79edfbe81680323ea6e70965c80c

See more details on using hashes here.

Provenance

The following attestation bundles were made for keshro-0.1.12.tar.gz:

Publisher: publish.yml on jlewitt1/keshro-cli

Attestations: Values shown here reflect the state when the release was signed and may no longer be current.

File details

Details for the file keshro-0.1.12-py3-none-any.whl.

File metadata

  • Download URL: keshro-0.1.12-py3-none-any.whl
  • Upload date:
  • Size: 76.9 kB
  • Tags: Python 3
  • Uploaded using Trusted Publishing? Yes
  • Uploaded via: twine/6.1.0 CPython/3.13.7

File hashes

Hashes for keshro-0.1.12-py3-none-any.whl
Algorithm Hash digest
SHA256 7cd38f3541ed422e9227706ad43febc4110c66820e763bb3b29dcfa0f8f6041f
MD5 3ea28acc8d82f2f923671175095dd668
BLAKE2b-256 14c556e846b9364c06267649ae38ae05f19d3ba4ed6dc5733b2c1fb8e24a4217

See more details on using hashes here.

Provenance

The following attestation bundles were made for keshro-0.1.12-py3-none-any.whl:

Publisher: publish.yml on jlewitt1/keshro-cli

Attestations: Values shown here reflect the state when the release was signed and may no longer be current.

Supported by

AWS Cloud computing and Security Sponsor Datadog Monitoring Depot Continuous Integration Fastly CDN Google Download Analytics Pingdom Monitoring Sentry Error logging StatusPage Status page