Skip to content

Chief

The chief is the host’s main agent: it reaches every module the host runs and operates the system for the people who own it. One chief per host; it runs turns through the agent like a team member, and can wake and direct team members through the board as people do.

  • In the app: the chief’s chat, like any agent’s.
  • gRPC: pcx.agent.v1.Agent/RunTurn with agent: "chief".
  • MCP / channels: the tool chief_ask (the question, an optional conversation id) - what Telegram and other channel modules call.

A conversation is continued only by who started it, from the same channel. A dropped connection does not kill a turn: the conversation says whether one runs.

By default every tool an agent may call. Tools reserved for people (approving decisions, team and trust management) need an explicit grant by name; any tool can also be withheld. The grant lives in the chief’s settings and is enforced by the host - the chief cannot widen it. Every tool call of every turn is recorded (the tool, its input, whether it failed) and listed in the app, newest first.

Setting Default
workspace_id - required; where its conversations and actions live
name chief its author name in records
instructions - added to the system prompt
model the agent’s
budget_tokens 2,000,000 per UTC day; past it a turn is refused until tomorrow
person_tools / withheld - the grant