typebasedio
6c4c3e8df2
Records:
- Branch feat/v0.6-multi-agent-config is the active surface for v0.6;
Phase 1 (5 commits) is implemented, tested, and reviewed but the
branch is NOT merged into main. Phase 2 and Phase 3 will continue on
the same branch per the v0.6 spec's "one branch, three sequential
milestones" policy. The eventual merge happens at the end of Phase 3
alongside the version bump.
- The five Phase 1 commits with one-line summaries each:
6f80c8b config file parser + resolver + source attribution
0b21b8d schema_version and workspace.mode in task.yaml
c918e5c doctor Settings section with source attribution
937a1c8 info source attribution on Agent and Launch session mode
6182d89 platform-override stderr warning on launch paths
- Per-commit detail: what each commit landed, where the load-bearing
code lives, and what the test coverage is.
- Verification gate (all clean on tip 6182d89):
go test ./... -count=1, go vet ./..., go build, just build-linux
(statically linked ELF). Version stays v0.5.4 — bump is deferred
to the end-of-Phase-3 commit.
- Phase 1 constraints held: no config auto-creation, no opportunistic
schema writes, env vars remain overrides, task.yaml remains
workspace state, no Phase 2 or Phase 3 work started.
- Native-Windows platform-override behavior across the three surfaces:
* doctor + info — show source attribution
* launch paths (new/resume/last/open) — emit one stderr warning
per invocation and downgrade to direct
* attach — does NOT downgrade; continues to refuse via
preflightPersistentEntry because it has no direct-mode equivalent
- Architecture notes worth preserving for future Phase work:
"one resolver per command", exported test seams, validation in
ReadMeta rather than callers, omitempty as the load-bearing
primitive for no-opportunistic-writes.
- Files-committed list and "How to resume" section both updated to
point at Phase 2 as the next horizon and to enumerate the resume
sanity checks against the unmerged branch.
ctask
A local CLI that creates and manages named AI-agent task workspaces.
ctask gives developers dedicated directories with consistent structure, visible session identity, environment context injection, and automatic session logging -- so you can start, resume, and organize AI-assisted work more safely and predictably.
Status
v0.2.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)
- Session traceability -- automatic file-change snapshot logging on every session
- Agent-agnostic -- default agent is Claude Code, but any CLI agent or shell works
- 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
- Safe delete -- active workspace protection prevents accidental data loss
Install (Windows)
cd C:\Users\Warren\claude_tasks\ctask_v0.1
powershell -NoProfile -ExecutionPolicy Bypass -File scripts/install.ps1
Installs to %LOCALAPPDATA%\ctask\bin. Open a new terminal after install.
See docs/install.md for full details.
Quick Start
# Verify setup
ctask doctor
# Create a new task workspace and launch Claude Code
ctask new "fix auth bug"
# List recent workspaces
ctask list
# Resume where you left off
ctask last
# Or resume a specific workspace
ctask resume auth-bug
Commands
| Command | Description |
|---|---|
ctask new [title] |
Create a new workspace and launch the agent |
ctask list |
Show recent workspaces |
ctask resume <query> |
Reopen a workspace and launch the agent |
ctask open <query> |
Open a workspace in a shell (no agent) |
ctask info <query> |
Display workspace metadata |
ctask archive <query> |
Mark a workspace as archived |
ctask last |
Resume the most recently updated workspace |
ctask doctor |
Verify ctask setup |
ctask delete <query> |
Permanently remove a workspace |
See docs/commands.md for full usage.
Status Line
ctask includes a status-line helper for Claude Code that shows session context at the bottom of the UI:
(ctask:fix-auth-bug|local) C:\Users\Warren\ai-workspaces\general\2026-04-06_fix-auth-bug
Run ctask doctor to check if the status line is configured. See docs/install.md for setup.
Uninstall
cd C:\Users\Warren\claude_tasks\ctask_v0.1
powershell -NoProfile -ExecutionPolicy Bypass -File scripts/uninstall.ps1
Removes ctask files only. Your workspaces and task data are never touched.