Your context shouldn't live only on someone else's machine

Description and use

Managing context across multiple terminal agents is simplified with udctl, a self-hosted workspace that stores all conventions and tasks in a single library, enabling agents to read/write directly and automatically archiving daily entries.

Problem

When using multiple terminal agents, context and conventions are scattered across session logs, scratch files, and vendor databases, leading to duplicated effort, unclear ownership, and loss of work when switching machines.

Outcome

By centralizing context in udctl, the user eliminates duplicate conventions, retains all work across machines, and reduces repeated effort. Daily entries are systematically archived, ensuring long‑term memory without data loss.

Workflow

• 1. Install udctl on your machine.
• 2. Configure udctl to manage your agents (register agents, define skills).
• 3. Store conventions and context as markdown files in udctl’s library (e.g., a skill called code-reviewer).
• 4. Run agents; they read/write to the shared library via udctl commands.
• 5. Set up a daily gather job that archives daily entries into month cards and compacts them.
• 6. Access all cards and files through the virtual path tree exposed by udctl.
• 7. When switching machines, copy the udctl library to the new machine to retain context.

Evidence

udctl in one line: a self-hosted workbench that runs on your own machine. People and agents share one copy of the data and read the same bytes.

Source

One container holds it, any agent can read it, it gathers once a day, it settles into long-term memory, and it lands in a directory tree you can open.

Source