- Connect agent harnesses/providers.
- Open a workspace (your repo).
- Create tasks for bugs, features, and refactors.
- Run sessions and guide the agent with prompts.
- Review exactly what changed before you keep it.
How ctx is different from a chat-only tool
ctx is built around repository workflows, not just text output. In the GUI, you can:- Track work by task.
- Inspect code changes in diff review.
- Keep sessions isolated in worktrees.
- Tune execution choices (harness, model, effort, mode, runtime).
Core terms in the app
Workspace: the repository you are operating on.Task: one concrete objective (for example, “fix auth redirect bug”).Session: the live conversation where an agent executes.Worktree: the isolated code checkout tied to that session.
Who these docs are for
These docs are for people using ctx through the GUI. They focus on:- Day-to-day operation.
- Team-safe workflows.
- Worktree, container, and network setup.
- Troubleshooting common failures.