okra

AI agent orchestration toolkit. Seven subcommands:

• okra schedule — Schedule AI agent tasks via macOS launchd
• okra counsel — Route prompts between Claude and Codex for second opinions
• okra repo — Multi-registry source code cache for exploring external repos
• okra skills — Manage AI agent skills from GitHub repos or local paths
• okra image — Generate or edit images via codex or the OpenAI Images API
• okra keys — Manage stored provider API keys
• okra how — Print the embedded usage guide for any subcommand

Install

bun add --global @cvr/okra

Bun links the package entry point to ~/.bun/bin/okra.

Usage

# Schedule a recurring agent task
okra schedule "babysit this pr" -s "every weekday at 9am"

# Get a second opinion from the opposite agent
okra counsel "Review the auth refactor for blind spots"

# Install skills (variadic, multi-select for multi-skill repos)
okra skills add owner/repo                # all skills (multi-select prompt)
okra skills add owner/repo@name           # specific skill
okra skills add ~/path/to/skill           # local path
okra skills i owner/a owner/b ./local     # alias `i`, multiple at once
okra skills rm my-skill                   # alias `rm` for remove

# Cache an external repo for exploration
okra repo fetch effect-ts/effect-smol
okra repo path effect-ts/effect-smol

Development

bun install     # install dependencies
bun run gate    # typecheck + lint + fmt + test + build (parallel)
bun run dev     # run from source
bun test        # tests only

Stack

Effect v4 (beta.60), Bun, effect/unstable/cli, oxlint, oxfmt, lefthook.