38 lines
1.2 KiB
Plaintext
38 lines
1.2 KiB
Plaintext
TAKT Task File Format
|
|
=====================
|
|
|
|
Tasks placed in this directory (.takt/tasks/) will be processed by TAKT.
|
|
|
|
## YAML Format (Recommended)
|
|
|
|
# .takt/tasks/my-task.yaml
|
|
task: "Task description"
|
|
worktree: true # (optional) true | "/path/to/dir"
|
|
branch: "feat/my-feature" # (optional) branch name
|
|
piece: "default" # (optional) piece name
|
|
|
|
Fields:
|
|
task (required) Task description (string)
|
|
worktree (optional) true: create shared clone, "/path": clone at path
|
|
branch (optional) Branch name (auto-generated if omitted: takt/{timestamp}-{slug})
|
|
piece (optional) Piece name (uses current piece if omitted)
|
|
|
|
## Markdown Format (Simple)
|
|
|
|
# .takt/tasks/my-task.md
|
|
|
|
Entire file content becomes the task description.
|
|
Supports multiline. No structured options available.
|
|
|
|
## Supported Extensions
|
|
|
|
.yaml, .yml -> YAML format (parsed and validated)
|
|
.md -> Markdown format (plain text, backward compatible)
|
|
|
|
## Commands
|
|
|
|
takt /add-task Add a task interactively
|
|
takt /run-tasks Run all pending tasks
|
|
takt /watch Watch and auto-run tasks
|
|
takt /list-tasks List task branches (merge/delete)
|