callee

Callee

Markdown-defined agents and deterministic workflows

Callee lets a repository define provider-backed Role, Sequential, and Loop agents as versioned Markdown or YAML. Markdown is the base authoring and generation format; YAML represents the same complete schema object with spec.body inline. Every kind has the same node boundary: it receives input, may update one root-run state object, and returns one artifact or a structured orchestration outcome.

Callee remains CLI-only. It uses Norma Runtime for ACP provider processes and Go ADK-aligned escalation semantics. It has no server, durable thread store, or handle binding.

Documentation

See the Callee engineering documentation for detailed guides, architecture, reference, and contributor material. This README stays focused on installation and first use.

Agent skills

Callee installs two complementary skills in your coding host:

Skill	What it does	Result
Run Agent	Discovers project-defined agents, resolves the selected tree and required parameters, and runs a Role, Sequential, or Loop agent through its controlling terminal.	The completed root artifact and a concise capability trace, followed by the emitted run-wide and per-Role execution metrics.
Create Agent	Authors a reusable Role, Sequential, or Loop in Markdown or YAML, using an embedded PromptKit template when one fits, then validates the file and resolved tree.	A validated agent or deterministic workflow below .callee/.

These skills are host integrations: they teach Codex, Claude Code, Grok Build, Copilot CLI, OpenCode, or Cursor how to create and run Callee agents. Runtime ACP providers are a separate layer selected by spec.provider.type; they supply the model session for each Role. Host setup does not install or authenticate an ACP provider, even when the host and provider share a name.

Set up your coding host

Run setup from the project root with the complete one-shot npx command for your host below. No global Callee installation is required; each cell is directly executable as written. Setup installs both skills and six editable starter agents.

Host	Setup	Run Agent	Create Agent
Codex	npx --yes @baldaworks/callee@latest setup codex	$callee:run-agent	$callee:create-agent
Claude Code	npx --yes @baldaworks/callee@latest setup claude	/callee:run-agent	/callee:create-agent
Grok Build	npx --yes @baldaworks/callee@latest setup grok	/callee-run-agent	/callee-create-agent
Copilot CLI	npx --yes @baldaworks/callee@latest setup copilot	/callee-run-agent	/callee-create-agent
OpenCode	npx --yes @baldaworks/callee@latest setup opencode	callee-run-agent skill (/callee wrapper)	callee-create-agent skill (/callee-create-agent wrapper)
Cursor	npx --yes @baldaworks/callee@latest setup cursor	callee-run-agent skill	callee-create-agent skill

Codex, Claude Code, Grok Build, and Copilot CLI setup use the repository's plugin marketplace. OpenCode setup writes skills and convenience commands below .opencode/; Cursor setup writes skills below .cursor/skills/. Existing local files are preserved; use --force only when setup-managed assets should be replaced. Host CLIs and credentials remain external.

Use Callee from your host

In Codex, invoke the Callee plugin directly and describe the outcome. Callee routes the request to the appropriate installed skill, so the :run-agent or :create-agent suffix is optional:

$callee Run workflows/investigate to explain this project's architecture and main entry points.

Create a reusable Role while selecting its provider, model, and reasoning:

$callee Create a Go code-review Role named roles/go-reviewer using the codex provider, model gpt-5.6-sol, and high reasoning.

Or compose existing agents into a deterministic workflow: