Create a new task and start tracking it.

Use this when the user wants to begin a new tracked task. The task will be saved to ~/.task-hub/tasks//.

Args: name: Task name (will be slugified for the directory name) description: What this task is about tags: Optional tags for filtering (e.g. ["bioinfo", "ngs"])

Save the current state of a task.

Call this when the user says "save", "保存", or wants to checkpoint progress. The context parameter should be a concise summary of the current state — goals, what's done, what's next, key decisions.

Args: name: Task name or ID context: Current context summary (distilled, not raw conversation) progress: Progress update to append decisions: New key decisions made (list of strings) pitfalls: New pitfalls discovered (list of strings) artifacts: Files to snapshot [{"path": "/abs/path", "description": "..."}] agent: Which agent is saving (e.g. "claude-code", "codex", "hermes") messages: Optional conversation messages to append to conversation.jsonl expected_revision: Revision returned by task_load; rejects stale saves

Load a task's context to continue working on it.

Call this when the user says "load task X", "加载 X 任务", or wants to resume a specific task. Returns the distilled context (context.md) that gives you everything you need to continue the task.

Args: name: Task name or ID include_conversation: If true, also include the full conversation log

List all saved tasks.

Call this when the user says "what tasks do I have", "有哪些任务", or wants to see what's available before loading one.

Args: status: Filter by status ("active", "paused", "archived") tag: Filter by tag

Continue a task, reactivating it when paused.

Call this when the user says "continue where I left off", "继续上次的", or "resume". With no name, the most recent active task is loaded; if none is active, the most recent paused task is reactivated.

Args: name: Optional task name or ID to load or reactivate

Stop tracking a task by pausing or archiving it.

Call this when the user says "stop tracking", "不用追踪了", or wants to archive/finish a task.

Args: name: Task name or ID reason: Why the task is being stopped archive: Permanently archive instead of pausing expected_revision: Revision returned by task_load; rejects stale updates