Concepts

These pages explain how flockr organizes terminals and how it tracks the agents running in them.

• Sessions, spaces, tabs, and panes: how a session is laid out, how it persists, and how worktree spaces work.
• Agent states: what working, blocked, done, and idle mean, how agents report them, and when a done badge clears.
• The sidebar: the spaces and agents lists, filters, numbering, and how to change what each row shows.