diff options
| author | Paul Buetow <paul@buetow.org> | 2026-03-27 22:39:50 +0200 |
|---|---|---|
| committer | Paul Buetow <paul@buetow.org> | 2026-03-27 22:39:50 +0200 |
| commit | 1575c64b7d40f4a7b462609242bd72885157a383 (patch) | |
| tree | 31e21bf96769759f16eb4375e27273c824b104c8 /docs/usage.md | |
| parent | 2ddb334fa671b9c425ca43c8c673c6b36c3ad0ab (diff) | |
Diffstat (limited to 'docs/usage.md')
| -rw-r--r-- | docs/usage.md | 15 |
1 files changed, 14 insertions, 1 deletions
diff --git a/docs/usage.md b/docs/usage.md index 8a1c1d1..8824a44 100644 --- a/docs/usage.md +++ b/docs/usage.md @@ -125,7 +125,9 @@ cat SOMEFILE.txt | hexai --tps-simulation 20 ## Task management -`ask` is a task management CLI for the current git project. It auto-scopes to `project:<repo> +agent` so all operations are confined to the current project. +`ask` is a task management CLI for the current git project. By default it auto-scopes to `project:<repo> +agent` so operations are confined to agent-managed project tasks. + +Use `ask na <subcommand...>` or `ask no-agent <subcommand...>` to run the same subcommands against project tasks without the `+agent` tag. Those prefixes keep the project scope but replace the default tag filter with `-agent`. `ask` never exposes Taskwarrior numeric task IDs. Human-facing output uses stable local alias IDs where practical, while `ask info` shows both the alias ID and the UUID. Commands that accept a task selector support either the alias ID or the UUID. @@ -139,7 +141,9 @@ cat SOMEFILE.txt | hexai --tps-simulation 20 | `ask add depends:<id\|uuid>,<id\|uuid> "description"` | Create task with inline dependencies | | `ask add priority:H "description"` | Create task with priority | | `ask add +tag "description"` | Create task with tag | +| `ask na add "description"` | Create a project task without the `+agent` tag | | `ask list` | List pending tasks only (alias-ID table) | +| `ask na list` | List pending project tasks without the `+agent` tag | | `ask all` | List all tasks including completed/deleted | | `ask list +READY` | List only ready tasks | | `ask list +BLOCKED` | List blocked tasks | @@ -169,15 +173,24 @@ cat SOMEFILE.txt | hexai --tps-simulation 20 # Create a task ask add priority:H "Implement new feature" +# Create a non-agent task +ask na add "Follow up manually" + # Create a task with dependencies ask add +cli depends:0,1 "Implement dependent feature" # List tasks ask list +READY limit:5 +# List non-agent tasks +ask no-agent list + # Show alias and UUID for a task ask info 0 +# Show a non-agent task +ask na info 0 + # Start working ask start 0 |