Spaces & Tasks

Nexion has one window. Inside it, a space is a context you work in, with its own projects, its own tabs, its own colour and its own browser profile. A project is a folder that keeps a list of tasks, and a task is one piece of work: its tab, the git worktree it runs on when it has one, and the agent conversation it carries.

Spaces

A space holds a whole workspace: the projects filed in it, the loose tabs below them, the pinned grid at the top. Client work in one, your own things in another, and neither shows the other's tabs.

  • •Move between them by clicking an icon in the strip at the foot of the sidebar, by swiping sideways with two fingers anywhere over the sidebar, or with Ctrl+Cmd+← and Ctrl+Cmd+→. The swipe follows your fingers and settles once you have come a quarter of the way.
  • •Make one with the plus at the foot of the sidebar, with Cmd+N, or from File > New Space. You give it a name, an icon, a colour and the browser profile its web tabs should use.
  • •The colour is optional. A new space starts without one, which is the sidebar exactly as it was before spaces existed; give it one when it has earned it.
  • •The browser profile is what a new web tab in that space uses, unless you ask for another one. A profile you set on a tab or a pane by hand always wins and is never overwritten by the space.
  • •Deleting a space asks first and says what goes with it. Its projects move to the first space rather than being deleted: a project is a folder with a history behind it, and losing that to a container being removed is a bigger thing than "delete space" promises.
  • •Cmd+1 to Cmd+9 number the rows of the space you are in, tasks and projects included.

Spaces replaced multiple windows. A tab used to belong to whichever window it was opened in, so the same project could show three different task lists depending on which frame you were looking at, and a task opened in one window could not be reached from another. Windows you had when you upgraded became spaces, one each, keeping their tabs and their order.

Projects

A project is a folder Nexion knows by name: it sits at the top of the sidebar with its tasks under it, and it stays listed whether or not anything of it is open. Opening a project gives you its dashboard: where it lives, its tasks grouped into running and paused, and the archive underneath.

  • •A project belongs to one space. Projects with nothing open start folded, so a long list stays a list.
  • •Extra paths and a setup list live in project settings: the setup entries are what gets linked into every worktree a task creates, so a task starts with the files git does not carry.
  • •The project container cannot be closed by Cmd+W or by the close button. Removing a project is its own action, behind a confirmation.

Tasks

A task outlives its tab. Close one and the row stays in the project, with what it was doing, so reopening it puts you back where you were, agent conversation included.

  • •On a branch of its own. Give a task a branch and it gets a git worktree, so two tasks on the same repository never fight over one checkout. Without one it works straight on the project folder.
  • •With an agent. A task can start Claude, Codex, Gemini, opencode, aider, GitHub Copilot or Antigravity in its pane, and the row wears that agent's mark. Reopening the task continues the conversation rather than starting a blank one.
  • •A loose tab can become a task, and a task can go back to being a loose tab: right-click the row and pick "Make a Task of…" or "Detach from Project". Nothing is recreated either way, so the shell keeps running and the agent keeps its conversation. A browser or a drawing can join any project; a terminal has to be somewhere the project already owns.
  • •Archived, not lost. Archiving a task closes it and files it away; the archive is on the project page, and a task comes back from it with its record intact.

Panes in a window of their own

A tab or a pane can be sent to a plain window with Move to New Window, from the tab's right-click menu or from a terminal pane's own. It is a move, not a copy: the shell keeps running, a page keeps the form you had half filled in, a drawing keeps its editor, and nothing restarts.

Closing that window is what brings the pane back. It returns where it came from: a pane taken out of a split goes back as a split beside the pane you are in, a tab that left whole goes back to its own row, in its project and its space. Quitting Nexion brings every one of them home first.

From the command line

Everything here is scriptable, so a script can build a context and drop you into it. See the CLI reference for the full list. 

$ nexion space new "Client work"
$ nexion project new ~/code/api
$ nexion task new "Rate limits" --project api --branch rate-limits --agent claude
$ nexion space next