/ctx · Documentation
The CortexFS handbook
From your first mount to the runtime internals. Choose the task in front of you.
Find your next step
Search guide titles, descriptions, and common commands.
18 guides
Get started
Work with agents
- Daily usageConfigure providers, use tools, and continue durable sessions.
- Shell clientConnect a shell client to the agent socket and inspect its events.
- Runtime & terminalsUnderstand process lifecycle, terminal access, and execution limits.
- Sessions & historyFind messages, events, indexes, and the rebuildable context.
Build & evaluate
- Write an extensionAdd tools and agents through the existing object contracts.
- Connect a chat channelRoute messaging platforms to the same agent and session interfaces.
- Contributor workflowBuild the workspace and follow repository verification conventions.
- Evaluate the harnessRun reproducible scenarios and inspect the evidence behind each result.
- Provider mock testsExercise model requests with controlled, local provider fixtures.
Understand the system
- System architectureRead the responsibilities and boundaries of the runtime.
- Internal layersTrace crate dependencies, error handling, and the migration plan.
- Root ABIStart with the root entries and their filesystem semantics.
- Object ABIRead the executable, socket, and control-file contract.
- Permissions & isolationCheck the agent identity, mount view, and authority boundaries.
- Path referenceLook up shared path constants and filesystem conventions.
- Complete specificationBrowse the normative ABI documents and their scope.