Open-source developer tooling

Thetoolchainfor
agentic AI

Route commands. Orchestrate parallel agents. Convert any API spec into agent-ready tools. One CLI, every workflow.

v1.1.1 · MIT · Node 18+
30+CLI commands
UnlimitedParallel agents
Any specAPI integrations
MITLicense

Stop merging. Start orchestrating.

Parallel agents.
Zero collisions.

Workspaces

Every task runs in its own git worktree

Claims

File-level locks prevent edit conflicts

DAGs

Workflows execute in dependency order

Executors

Claude Code, Aider, Codex, or any CLI

~/.project
# Create parallel tasks with file isolation
$ ruah task create auth \
    --files "src/auth/**" \
    --executor claude-code

$ ruah task create ui \
    --files "src/ui/**" \
    --executor aider

# Both execute simultaneously — zero conflicts
$ ruah task start auth
$ ruah task start ui

# Merge in dependency order
$ ruah task done auth && ruah task merge auth
$ ruah task done ui   && ruah task merge ui

See it

Watch it work.

Terminal recordings from the actual tools. No mockups, no edits.

Parallel agents. Zero collisions.

Multi-agent orchestration that coordinates code changes. Each task gets an isolated workspace, file-level claims prevent conflicts, and merges happen in dependency order.

  • Git worktree isolation
  • File-level claims (owned/shared/read-only)
  • Workflow DAGs with dependencies
  • Durable task artifacts
  • Compatibility-check engine
  • 6 executor adapters
@ruah-dev/orch
ruah demo — worktree isolation, file locking, conflict detection, and DAG scheduling

Any spec. Agent-ready tools.

Convert API specs into agent-ready tool surfaces. Feed it an OpenAPI spec, get MCP tool definitions, function-calling schemas, or a full MCP server scaffold.

  • OpenAPI, Swagger, Postman, GraphQL, HAR input
  • MCP, OpenAI, Anthropic, A2A output
  • Risk classification (safe/moderate/destructive)
  • TypeScript & Python server scaffolds
  • Intermediate representation (Ruah Tool Schema)
  • Single runtime dependency
@ruah-dev/conv
ruah-conv — inspect, validate, and generate MCP tool definitions from API specs

Capabilities

Everything you need, nothing you don't

Workspace isolation

Every task runs in its own git worktree. No stash juggling, no stepping on each other's files. Clean separation by design.

owned

shared

read-only

File-level claims

Mark files as owned, shared, or read-only. Conflicts are caught before agents start.

Workflow DAGs

Define workflows in markdown. Tasks run in dependency order with automatic parallelization.

Spec conversion

OpenAPI, Swagger, Postman, GraphQL, HAR → MCP servers, function-calling schemas, A2A wrappers.

Multi-executor

Claude Code, Aider, Codex, OpenCode, or any shell command. Mix agents freely.

Zero dependencies

The orchestrator has no runtime dependencies. The converter needs only yaml.

Compatibility

Works with everything

Claude CodeAiderOpenAI CodexOpenCodeShell ScriptRaw CLIClaude CodeAiderOpenAI CodexOpenCodeShell ScriptRaw CLIClaude CodeAiderOpenAI CodexOpenCodeShell ScriptRaw CLIClaude CodeAiderOpenAI CodexOpenCodeShell ScriptRaw CLI
OpenAPI 3.xSwagger 2.0Postman v2.1GraphQL SDLHARMCP ServerOpenAI ToolsAnthropic ToolsA2A ServiceOpenAPI 3.xSwagger 2.0Postman v2.1GraphQL SDLHARMCP ServerOpenAI ToolsAnthropic ToolsA2A ServiceOpenAPI 3.xSwagger 2.0Postman v2.1GraphQL SDLHARMCP ServerOpenAI ToolsAnthropic ToolsA2A ServiceOpenAPI 3.xSwagger 2.0Postman v2.1GraphQL SDLHARMCP ServerOpenAI ToolsAnthropic ToolsA2A Service

Workflow

Three steps. That's it.

1

Define

Write a workflow in markdown or create tasks from the CLI. Specify which files each agent owns, which executor to use, and what depends on what.

# .ruah/workflows/feature.md
- auth:
    files: src/auth/**
    executor: claude-code
- ui:
    files: src/ui/**
    executor: aider
    depends: [auth]
2

Orchestrate

Each task gets an isolated workspace via git worktrees. Agents run in parallel where the dependency graph allows. File claims prevent collisions before they happen.

$ ruah workflow run feature.md

[auth] Workspace created
[auth] Claimed: src/auth/** (owned)
[auth] Executing with claude-code...
[ui]   Waiting on: auth
[auth] ✓ Complete
[ui]   Workspace created
[ui]   Executing with aider...
3

Merge

Changes merge back in dependency order. Governance gates validate each step. Clean commit history. Zero conflicts.

$ ruah workflow status

auth ........... ✓ merged
ui ............. ✓ merged

2/2 tasks complete.
0 conflicts. 0 gate failures.

Ready to build?

Node.js 18+. Zero runtime dependencies. MIT licensed. Works with every AI coding agent.