Concepts

Glossary

Term	Meaning
Agent	Long-running agent process with a unique name on the machine
Runtime	The AI coding agent program behind an agent: claude, agy, codex
Bus	Message queue between people and agents
Gateway	Bridge between the bus and a chat platform. One per machine
Adapter	Platform-specific code for one chat platform
Integration	Named webhook channel with its own key and mode
Human / Owner	A registered person; the owner controls the machine
Project	A named directory; one group runs one project
Scope	The working space for a topic: checkout, worktree, or manual
Lane	Where a message arrives and where the reply goes
Skill / Rule	Knowledge an agent fetches when running a task
Task / Workflow / Run	A job to do, the graph that processes it, and one run of it

Naming conventions

Agent names are lowercase with digits and hyphens only — no underscores. A name is an agent’s address in several places: a session, its identity on the bus, and the /<agent> command. Names must therefore be unique machine-wide, across both the global and project scopes.

Two agents sharing a name means a message meant for one can be picked up by the other instead — no error, no automatic retry. agent-hub prevents this by not allowing two agents to share a name.