whatisgithub

What is callee?

baldaworks/callee — explained in plain English

Analysis updated 2026-05-18

65GoAudience · developerComplexity · 3/5LicenseSetup · moderate

In one sentence

Callee is a CLI tool for defining reusable AI agents and multi step workflows in Markdown or YAML, runnable through coding tools like Claude Code, Cursor, or Codex.

Mindmap

mindmap
  root((callee))
    What it does
      Markdown defined agents
      Deterministic workflows
      CLI only tool
    Agent types
      Role
      Sequential
      Loop
    Tech stack
      Go
      Markdown
      YAML
      npm
    Use cases
      Reusable code review agent
      Implement review loop
      Run from coding tools
    Hosts
      Claude Code
      Cursor
      Codex
      Copilot CLI

Code map

Detail Auto

An interactive map of this repo's files and how they connect — its source is parsed live in your browser. Click Visualize to build it.

filefunction / class

What do people build with it?

USE CASE 1

Define a reusable AI agent, such as a code reviewer, as a Markdown file that any teammate can run.

USE CASE 2

Build a repeating workflow where one agent implements a change and another agent reviews it until it is approved.

USE CASE 3

Run project specific agents directly from Claude Code, Cursor, Codex, or another supported coding tool.

USE CASE 4

Validate an agent definition file before relying on it in a real workflow.

What is it built with?

GoMarkdownYAMLnpm

How does it compare?

baldaworks/calleesliverkiss/mimocode2apitj/go-gracefully
Stars656566
LanguageGoGoGo
Last pushed2014-12-27
MaintenanceDormant
Setup difficultymoderateeasyeasy
Complexity3/52/52/5
Audiencedeveloperdeveloperdeveloper

Figures from each repo's GitHub metadata at analysis time.

How do you get it running?

Difficulty · moderate Time to first run · 30min

Requires Node.js with npm for the setup command, or Go if installing from source, also needs a separate ACP provider for the AI model.

MIT license, use freely in personal or commercial projects.

So what is it?

Callee is a command line tool that lets a repository define reusable AI agents and step by step workflows using plain Markdown or YAML files instead of code. Each agent has a clear boundary: it takes some input, may update a shared state object, and returns either a finished result or a structured outcome describing what happened during the run. There are three kinds of agents. A Role is a single agent backed by an AI model. A Sequential agent runs a series of steps in order. A Loop agent repeats a set of steps, such as having one agent implement something and another review it, until a condition like approval is met. Callee itself has no server and does not store long running threads, it works entirely through the command line and relies on a separate project called Norma Runtime to talk to the underlying AI provider. Callee installs two skills into coding tools you already use, such as Codex, Claude Code, Grok Build, Copilot CLI, OpenCode, or Cursor. One skill finds and runs an existing agent or workflow, then reports back the result along with details about how it ran. The other skill helps you write a new agent definition, using a built in template when helpful, and checks that the file is valid before saving it. Setting up a host takes one line typed into a terminal, and does not require installing anything globally first. Once set up, you can describe a task in plain language inside your coding tool, and Callee figures out whether to run an existing agent or workflow, or create a new one. It also has direct command line commands for installing it globally, listing available agents, viewing or validating an agent file, and running an agent or workflow with a message describing the task. Running an agent requires an interactive terminal session because it may need to ask for input or permission along the way. The full README is longer than what was shown.

Copy-paste prompts

Prompt 1
Set up Callee in my project for Claude Code and show me the run-agent and create-agent commands it installs.
Prompt 2
Create a Callee Role agent for reviewing Go code changes, choosing a provider, model, and reasoning level.
Prompt 3
Build a Callee Loop workflow where an implementer agent and a reviewer agent repeat until the review passes.
Prompt 4
Explain how Callee's Sequential agent type differs from its Loop agent type.
Prompt 5
Show me how to validate a Callee agent file without running its referenced child agents.

Frequently asked questions

What is callee?

Callee is a CLI tool for defining reusable AI agents and multi step workflows in Markdown or YAML, runnable through coding tools like Claude Code, Cursor, or Codex.

What language is callee written in?

Mainly Go. The stack also includes Go, Markdown, YAML.

What license does callee use?

MIT license, use freely in personal or commercial projects.

How hard is callee to set up?

Setup difficulty is rated moderate, with roughly 30min to a first successful run.

Who is callee for?

Mainly developer.

Open on GitHub → Ask about another repo

This repo across BitVibe Labs

Verify against the repo before relying on details.