Projects
A project is a named reference to a directory. Everything else in toryo resolves work against a project by its stable id instead of carrying raw paths around: dispatch jobs, schedules, sequence runs, and every piece of knowledge.
Registering a repository is the first thing you do after installing:
toryo project add --name web --root /path/to/your/repo
The hierarchy#
A project can have a parent, which models customer → repository. A customer is a project with no parent; its repositories sit beneath it.
This matters for knowledge. A memory or document can be pinned to the customer or to a specific repository, and a search pinned to the parent surfaces everything from its children too. Customer-wide knowledge belongs on the parent project, because global means your entire world, across every customer, not one of them.
A parent still has a directory of its own, typically the umbrella folder holding its repositories.
Per-project settings#
- Code indexable, whether the code index walks this tree. Off for customer parents (their children already cover the source) and for repos with no source in them.
- Docs glob, which files the Refresh docs button pulls into the
library. The default is markdown under
docs/; override it for a repository that keeps non-prose there.
Deliberately minimal#
A project row holds an id, a name, a handle, a directory, its parent, and those two flags. Nothing more.
There are no sub-project paths: a consumer that needs a subdirectory appends a relative path at the point of use, the same way every toryo command takes explicit paths. Modelling subdirectories here would duplicate what is already on disk and go stale.
Richer per-project detail lives in the app that owns it, keyed by the project id.
Removing a project#
Removal is a hard delete. The knowledge attached to it (memories, documents, the code index) is cleaned up afterwards, with a nightly sweep on the scheduler's system lane as a safety net for anything the immediate cleanup missed.
In board#
The Projects screen registers and edits projects, sets the parent, toggles code indexing, and holds the Refresh docs button.
Full command surface: CLI & contract reference.