oya-cli 0.2.0

Build, deploy, debug, and share AI agents on the Oya runtime — from your terminal.

oya-cli

Build, deploy, debug, and share AI agents on the Oya runtime — from your terminal.

Oya is an agent runtime: describe an agent, we deploy it in a sandbox, expose it via chat, webhooks, schedules, or an OpenAI-compatible API. This CLI is the developer-side surface — and the engine behind the Oya Claude Code skill.

Install

pipx install oya-cli   # recommended
# or
pip install oya-cli

Quick start

oya login                        # save your API key (from https://oya.ai/api-keys)
oya quickstart                   # 60-second wow — pick a template, deploy
oya install-claude-skill         # use Oya from Claude Code

What you get

oya quickstart                   # interactive 60-second build → deploy
oya agent list                   # your agents
oya agent runs <id> --status failed
oya agent run <id> <job_id>      # full stdout/stderr/error of a single run
oya agent thread <thread_id>     # full chat history including tool calls
oya agent trace <trace_id>       # Langfuse LLM trace

oya agent soul <id> --rule "..." --rule "..." --welcome "..."
oya agent skills add/update/remove/sync <id> ...
oya agent gateway oauth-start <id> <platform>
oya agent routine add/update <id|routine_id> ...
oya agent kb upload <id> <file>
oya agent deploy <id>

oya agent export <id> -o spec.oya.json   # share-ready JSON, no secrets
oya agent fork ./spec.oya.json           # clone someone else's agent
oya agent fork https://gist.../spec.oya.json

oya routine run <routine_id>             # manually trigger a routine
oya template list / get

Run oya --help or oya <subcommand> --help for full reference.

The Claude Code skill

oya install-claude-skill copies an Anthropic Claude Code skill to ~/.claude/skills/oya/. After that, you can ask Claude Code things like:

• "Create an Oya agent — a Facebook SDR for my SaaS"
• "Why did my AI SDR fail last night?"
• "Add a 9am pipeline summary routine to my SDR"
• "Fork this Oya agent: "

The skill drives this CLI under the hood. See claude-skill/README.md for details.

Config

• OYA_API_TOKEN — your API key. Stored at ~/.oya/config.json after oya login.
• OYA_API_URL — defaults to https://oya.ai. Set to https://dev.oya.ai for the dev environment.

Links

• Runtime: https://oya.ai
• Docs: https://oya.ai/docs
• Support: [e-mail]
• License: MIT