summaryrefslogtreecommitdiff
path: root/docs
diff options
context:
space:
mode:
authorPaul Buetow <paul@buetow.org>2026-03-27 07:14:16 +0200
committerPaul Buetow <paul@buetow.org>2026-03-27 07:14:16 +0200
commitf146fbc4cc25bcdeab19a0c1055c839776cebff4 (patch)
tree775bdf98d930b7f0fdd5bfe5ef0a31027b8e685d /docs
parent1d1d267c56b66af87b66b74c079cb211b9cf6d90 (diff)
askcli: support add depends selectors
Diffstat (limited to 'docs')
-rw-r--r--docs/fish-completion.md1
-rw-r--r--docs/usage.md4
2 files changed, 5 insertions, 0 deletions
diff --git a/docs/fish-completion.md b/docs/fish-completion.md
index f51d362..d707b77 100644
--- a/docs/fish-completion.md
+++ b/docs/fish-completion.md
@@ -6,6 +6,7 @@ It completes the top-level `ask` subcommands and the nested `ask dep` operations
It also completes task selectors for UUID-taking commands by reading pending tasks through `ask complete-uuids`, which uses the local alias cache for stable short IDs.
Fish suggests each task's alias ID first and also keeps the raw UUID available as a fallback selector.
Selector suggestions stop once a command has consumed its selector argument, and `ask dep add` / `ask dep rm` suggest selectors for both task positions.
+When typing `ask add depends:...`, Fish also completes the comma-separated dependency selector list inside the `depends:` modifier.
The script preserves the global `--json` flag.
Load it into the current Fish session:
diff --git a/docs/usage.md b/docs/usage.md
index c43f406..c2fe055 100644
--- a/docs/usage.md
+++ b/docs/usage.md
@@ -136,6 +136,7 @@ cat SOMEFILE.txt | hexai --tps-simulation 20
| Subcommand | Description |
|---|---|
| `ask add "description"` | Create a new task and print its alias ID |
+| `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 list` | List pending tasks only (alias-ID table) |
@@ -168,6 +169,9 @@ cat SOMEFILE.txt | hexai --tps-simulation 20
# Create a task
ask add priority:H "Implement new feature"
+# Create a task with dependencies
+ask add +cli depends:0,1 "Implement dependent feature"
+
# List tasks
ask list +READY limit:5