The terminal shell

Every space is also a set of folders. The terminal lets you walk them, read cards as text, and make and change cards by typing. An agent connected with the shell profile types the same commands.

Opening it

Press Ctrl and the backtick key in a space, on a Mac too. Press it again to put the terminal away.
Or search for “terminal” with Cmd+K (Ctrl+K off a Mac).
It works on the space open in that tab, and follows you when you open another one there.

Getting around

`ls`	What is in this folder.
`cd <folder>`	Step into a folder. Two dots step back out, and a slash is the top of the space.
`pwd`	Where you are.
`tree /`	The whole space at once.
`find / -name <words>`	Cards whose names match.
`atomics show <card>`	Bring a card or folder into view on the canvas.

Files and folders

`cat <card>`	Read a card as text.
`mkdir <name>`	Make a folder.
`mv <card> <folder>/`	File a card into a folder.
`cp`, `rm`, `rmdir`, `touch`	Copy, remove and make, as anywhere else.
`info <card>`	What a card is and what it holds: a board’s lanes, a calendar’s types.
`undo`, `redo`	The same undo as the canvas, so a change typed here can be taken back there.

The usual text tools work on what a card says: grep, sed, awk, sort, head, tail, wc, jq, diff and more. Type help bash for the list.

Cards by type

Each kind of card has a command named after it, with its own verbs. new makes one of any kind. help lists every type and its verbs, and a type with --help shows that one in full.

$ new note "Call notes"
$ table new Leads Name Email Stage:select=Applied/Interviewing
$ table add Leads Name=Ada Stage=Applied
$ table cat Leads --csv
$ page move Acme Interviewing
$ calendar agenda Deadlines
$ article outline "Cover letter"
$ help
$ table --help

The types there are:

page board calendar list timer ruler map note notebook article chat table link folder media embed code automation app stream

Across spaces

`atomics ls`	Your spaces: the id, where each one lives, and its name.
`atomics <space>`	Open a space in a new tab, by its id or a name only one of your spaces has.
`atomics -r <space>`	Open it in this tab instead.

For an agent

An AI agent can be handed this shell instead of a long list of tools. Connect it with the shell profile and it types these same lines. The few things a line of text can’t do, such as uploading a file or looking at an image, stay as their own tools.

Connecting an agent with the shell profile