diff --git a/README.md b/README.md index 4d94cc2..686dcd4 100644 --- a/README.md +++ b/README.md @@ -6,16 +6,18 @@ ctask gives developers dedicated directories with consistent structure, visible ## Status -v0.2.0 -- local use, not published to any package registry. Windows-primary, cross-platform design. +v0.6.0 -- local use, not published to any package registry. Windows-primary, cross-platform design. ## Key Features -- **Named workspaces** with consistent layout (task metadata, notes, context, output, logs) +- **Named workspaces** with consistent layout (task metadata, agent instructions, notes, context, output, logs) - **Session traceability** -- automatic file-change snapshot logging on every session -- **Agent-agnostic** -- default agent is Claude Code, but any CLI agent or shell works +- **Agent-agnostic** -- built-in profiles for Claude Code and OpenCode, plus a `custom` escape hatch for any CLI agent or shell +- **Global config** -- optional user-level config file for defaults (agent, roots, session mode), with source attribution in `doctor` +- **Session recovery** -- PID-aware lease detection: a workspace whose owner process has died is recovered immediately, with no stale-wait - **Query resolution** -- find workspaces by name, slug, or substring - **Status line** -- persistent session context inside Claude Code's UI -- **Doctor** -- verify setup and diagnose configuration problems +- **Doctor** -- verify setup, diagnose configuration problems, and validate agent setup - **Safe delete** -- active workspace protection prevents accidental data loss ## Install (Windows) @@ -55,11 +57,16 @@ ctask resume auth-bug | `ctask new [title]` | Create a new workspace and launch the agent | | `ctask list` | Show recent workspaces | | `ctask resume ` | Reopen a workspace and launch the agent | -| `ctask open ` | Open a workspace in a shell (no agent) | -| `ctask info ` | Display workspace metadata | -| `ctask archive ` | Mark a workspace as archived | | `ctask last` | Resume the most recently updated workspace | -| `ctask doctor` | Verify ctask setup | +| `ctask open ` | Open a workspace directory without launching the agent | +| `ctask attach ` | Attach to a workspace via tmux (persistent session) | +| `ctask info ` | Display workspace metadata and path | +| `ctask path ` | Print the absolute filesystem path of a workspace | +| `ctask notes ` | Print a workspace's notes.md to stdout | +| `ctask archive ` | Mark a workspace as archived | +| `ctask restore ` | Un-archive a workspace (set status back to active) | +| `ctask agents check [workspace]` | Validate the agent configuration for a workspace | +| `ctask doctor` | Verify ctask setup and diagnose configuration problems | | `ctask delete ` | Permanently remove a workspace | See [docs/commands.md](docs/commands.md) for full usage.