Spaces

Overview#

A space is a set of pages about some of your work. The sidebar lists them under Spaces, just below Create New Task:

• All projects covers every repository in the window. Its orange count is how many things need you.
• A space for each repository is made for you the first time the repository is in the sidebar.
• Your own spaces, for a launch, a migration, or anything else, in the order you give them.
• New Space makes another.

Every space starts with three pages, shown as tabs:

• Inbox opens first. It says in plain English what your agents are doing and what needs you, then lists what is waiting on you (an agent's question, a failed run, a manager's question), what is ready for review, and what got done today. Beside it: the agents at work, CI on each main branch, every agent's face, and a field to ask about your work.
• Board shows every task as a card, in columns by label. Drag cards between columns to relabel them; each card shows its agent's state, its last message, its pull request and its changes. Filter by text, or show only what needs you or what is working.
• Usage shows your subscription limits and what your agents spent.

Click + beside the tabs to add a page: describe one and an agent lays it out, bring back the Inbox, Board or Usage if you removed it, or start from a template.

Agentastic draws every page itself, from a short definition. That keeps spaces fast and consistent, and it means an agent can make or change one for you without writing a page.

Making a space#

Click New Space in the sidebar (or the grid button on the Create New Task row, or View ▸ Spaces ▸ New Space…), pick the projects it is for, then:

• Describe it. Write what you want ("the launch: PRs waiting for review, CI on main and a checklist"). An agent lays out its first page from the tiles below; Settings ▸ Tasks ▸ Draft a Space chooses its model and prompt.
• Start from a template. Each adds its page beside the Inbox, Board and Usage: Release, PR Queue, Sentry Triage, Standup, Repo Overview, Flaky Tests, Migration and Notebook.
• Blank. Just the Inbox, Board and Usage.

The same sheet lists the spaces you made, with Show in Sidebar and Restore for archived ones.

Tiles#

Tiles come in five sizes on a four-column grid (two columns, or one, when the window is narrow): small, medium, large, wide and full. Tiles that read GitHub or a plugin show when they last refreshed and refresh on their own every few minutes while the space is on screen; a failed refresh keeps the last data and shows the error.

Changing a space#

• Customize (the sliders beside the tabs) removes, renames and reorders pages, and adds, removes, resizes and reorders tiles (drag them, or use the arrows). It also opens each tile's settings: its title, repositories, labels, branch, filter, query or prompt. Right-click a tab to rename or move it.
• Ask. The field at the bottom of every page of tiles takes a request ("add CI for the release branch", "a checklist for launch day"); an agent rewrites the page and Undo puts it back.
• ⋯ ▸ Space Settings changes the title, icon, color, description and scope (the repositories and labels tiles read unless they name their own), and shows the definition as JSON.
• ⋯ ▸ Version History lists every saved version; restoring one saves it as the newest.

Checklist items, notes and links are kept apart from the layout, so none of these changes lose them.

Spaces and agents#

Agents use dev space: they can make a space from a definition, change it, and keep its checklists current. A migration agent, for example, ticks steps off as it finishes them:

dev space catalog prints every page and tile type with the sizes and settings it accepts, and dev space page add <space> --type tiles --title Launch adds a page.