Skip to main content
Agent Swarm CLI is the built-in terminal app for agency-swarm. The preview below shows the current tui() startup screen. Agent Swarm CLI startup screen Use one command: 
agency.tui()
tui() sets up the terminal app on first run, caches it locally, shows a short setup message, and opens the TUI for your current agency. Use agency.tui(reload=False) to disable hot reload on file changes.

​
What You Can Do

  • start the TUI with one Python call
  • switch between agencies and agents with /agents
  • send prompts with mentions such as @Developer fix the failing integration test
  • stream responses, export sessions, undo or redo, and use /compact

​
Choose Agencies And Agents

Use /agents to open the target picker. Agent Swarm CLI agent picker The picker reads live metadata from the running agency-swarm backend and groups agents by agency. Use Tab to autocomplete agent mentions in the prompt box.
agency.tui() already opens the TUI for the current local agency.The extra connection flow is only for the case where you want the TUI to switch to a different local agency-swarm server after startup.In that case, use /connect inside the TUI and point it at the other local server.

​
Current Limitations

These commands and modes are intentionally unavailable in the current terminal workflow:
  • /models
  • /editor
  • /issues
  • /commit
  • docs mode
tui(show_reasoning=False) is not supported in the new TUI yet.