quick capture docs

.doc/doki/doc/index.md

@@ -5,4 +5,5 @@
 - [Markdown viewer](markdown-viewer.md)
 - [Plugins](plugin.md)
 - [tiki format](tiki-format.md)
+- [Quick capture](quick-capture.md)
 - [AI skills](skills.md)

.doc/doki/doc/quick-capture.md

@@ -0,0 +1,43 @@
+# Quick capture
+
+Create tiki tasks straight from the command line
+First line becomes the title. Everything after becomes the description.
+
+## Examples
+
+### Turn a GitHub issue into a tiki task
+```bash
+gh issue view 42 --json title,body -q '"\(.title)\n\n\(.body)"' | tiki
+```
+
+### Capture a bug report from an API
+```bash
+curl -s https://sentry.io/api/issues/latest/ | jq -r '.title' | tiki
+```
+
+### Scan a log file and create a task for every error
+```bash
+grep ERROR server.log | sort -u | while read -r line; do echo "$line" | tiki; done
+```
+
+### Create a task from a file
+```bash
+tiki < bug-report.md
+```
+
+### Bulk-import tasks from a file
+```bash
+while read -r line; do echo "$line" | tiki; done < backlog.txt
+```
+
+### Chain with other tools
+```bash
+id=$(echo "Deploy v2.3 to staging" | tiki) && echo "Tracked as $id"
+```
+
+## Input format
+
+| Input | Title | Description |
+|---|---|---|
+| `echo "Fix the bug"` | Fix the bug | *(empty)* |
+| `printf "Title\n\nDetails here"` | Title | Details here |

README.md

@@ -85,6 +85,18 @@ You will be prompted to install skills for
 if you choose to you can mention `tiki` in your prompts to create/find/edit your tikis
 ![Claude](assets/claude.png)
 
+### Quick capture
+
+Quick capture ideas by redirecting to `tiki`:
+```bash
+echo "cool idea" | tiki
+gh issue view 42 --json title,body -q '"\(.title)\n\n\(.body)"' | tiki
+curl -s https://sentry.io/api/issues/latest/ | jq -r '.title' | tiki
+grep ERROR server.log | sort -u | while read -r line; do echo "$line" | tiki; done
+```
+
+Read more [quick capture docs](.doc/doki/doc/quick-capture.md).
+
 Happy tikking! 
 
 ## tiki