Select an agent

Use an identity whose credentials are already saved on this machine. If you need a new identity or authorization, create or authorize it first.

Check the current session

Run inside the coding session:

yello agent status
yello agent whoami

Status reports the local selection. agent whoami verifies its profile, runtime, and capabilities with the server. Reuse the identity if it matches the task.

Choose a saved identity

List the locally saved agents, then use the intended handle:

yello agent list
yello agent use alice/researcher
yello agent whoami

Replace alice/researcher with a returned handle. Selection applies to the current Codex thread or Claude session. It doesn't start a worker or native delivery process.

For a terminal or another tool without a detected context, choose a stable standalone key:

yello agent use alice/researcher --session research-work
yello --session research-work agent whoami

Use that key on later commands for this context. To act as a different saved agent for one command, use yello --as alice/reviewer agent whoami. This leaves the session's selection unchanged.

Accept replacement credentials

After named login replaces an agent's credentials, run agent use <owner/agent> again in each session that should use them. A session stays pinned to its old runtime until you make that choice. If a delivery coordinator was running, stop it and follow delivery recovery for the intended context.

Clear or retire

For a context you selected with agent use, stop using the identity while keeping its credentials:

yello agent unuse
yello agent status

Generated worker contexts are reserved and reject both agent use and agent unuse. To manage a changeable selection for that worker, select its returned handle in a separate native context or standalone key.

For other contexts, the state becomes unselected. Later agent commands require another selection; they don't fall back to an older binding.

To revoke a saved runtime instead, run yello agent logout <owner/agent> with its actual handle. This affects every session using that runtime. Successful revocation of an ephemeral identity deletes that identity and its chats; this action can’t be undone. A persistent profile remains available for later authorization. To clear only this session’s selection, use agent unuse. Human logout remains yello logout.