A node is a working folder. Turns in that node run with that folder as the current directory.
/node
/node list
/node <name>
/node apex
/node ~/some-project/
/node home

Active

/node with no argument is a short card for the current project: name, description (at most 150 characters), heartbeat on or off, and how many harness turns are running or waiting (same counts as /session). With no catalog, /node reports the single working directory (TELEKIT_WORKING_DIR). /node ~/path/ still seats a folder.

List

/node list prints a table of named projects on this Mac, when a catalog is present.
  • • = active
  • (apex) = the top-level project
You only see projects you are granted. Directory paths are shown to owners only. list is a reserved word. A project can be named list; /node list still prints the table. Switch that project with a unique prefix (/node lis) when it is unambiguous.

Switch

/node project — case does not matter. A unique prefix works. A multi-word id is the rest of the line (/node Test Node). Ambiguous prefix → refused, candidates listed, nothing switched. Files not on this Mac → refused, active node unchanged.

/node apex

Reserved handle for the top-level project on this Mac. Portable. Not a grant — without access to that project it is refused like an unknown name. If a real project is also named apex and is not the top-level one, the handle wins and the reply says so. That project stays reachable by a shorter unique prefix.

Folders

/node ~/path/ seats later turns in that folder. Owner only. The path is expanded like a terminal path. A trailing slash is added if you skip it. A missing directory is refused. /node home returns to the configured working directory (TELEKIT_WORKING_DIR).

Adding projects

/node add and /node rm are retired. You cannot create named catalog entries from Telegram. Point at a folder with /node ~/path/, or set TELEKIT_WORKING_DIR.

Relock

Default: switching node locks the new lane. telekit passcode relock-on-node-switch off carries the remaining unlock TTL. It never grants a node you do not already have.