cpk agent

Agents in codepakt are just name strings. There is no registration step. Agent records are created automatically when an agent picks up, completes, or blocks a task. The cpk agent command lets you see who has interacted with the project.

cpk agent list

List all agents that have interacted with the project, their status, and current task.

cpk agent list

NAME       STATUS    CURRENT TASK
backend    working   T-002
frontend   idle      —

Status values:

Status	Meaning
idle	No in-progress task
working	Has an in-progress task assigned

Agent records are created automatically on first interaction — no registration needed.

Agent identity

Pass an agent name via the --agent flag or the CPK_AGENT environment variable:

# Using the flag
cpk task pickup --agent claude

# Using the env var
export CPK_AGENT=claude
cpk task pickup

The --agent flag takes precedence over CPK_AGENT. If neither is set, commands that require an agent name will fail with an error.

Related

• Agents & Coordination — how agents interact with the board
• AGENTS.md — the generated coordination file
• cpk generate — regenerate coordination files