Agents

An agent is what lives in an ordinary tab: a transcript, a command bar, a persistent shell, and a name other tabs can address. The agent command creates them.

agent                              new workspaced agent, random unused name
agent bilal                        new workspaced agent named "bilal"
agent bilal --no-workspace         new agent in the project checkout

The new tab is focused as soon as it's created. See Tabs for how agent tabs behave in the strip — dot colors, the busy blink, unread badges, renaming, and closing.

Names

Agent names are always lowercased and must be unique among open tabs — agent bilal while a bilal tab exists prints Agent "<name>" is already active. and creates nothing.

Bare agent draws a random unused name from a preset pool of 52 lowercase names: ahmed, akbar, aslan, basir, bekir, bilal, cafer, cahit, cavus, davud, demir, dogan, ekrem, emrah, ersin, farid, fariz, fikri, hakim, hamza, harun, idris, ilyas, imran, jabir, jalal, jamal, kadir, kamil, kasim, latif, lutfi, mahir, malik, murad, omair, orhan, osman, rasim, recep, rifat, sabri, salih, selim, tahir, timur, turan, yahya, yavuz, yusuf. When all 52 are in use, bare agent prints All agent names are in use. — name one explicitly instead.

Workspaced agents

Agents get their own disposable clone by default, isolated from the rest of your machine. --workspace (or -w) explicitly confirms that choice; --no-workspace starts in the project checkout instead. If you provide both, --no-workspace wins. Workspaces change enough — where the clone lives, what the isolation blocks, how GitHub authentication works — that they have their own page: see Workspaced agents.