speckit.companion.after-tasks — Claude Code command
speckit.companion.after-tasks records task completion in .spec-context.json for Companion GUI. Intended to run from the repository root right after completing tasks.
MIT ★ 110 updated 2026-11-03
.claude/commands/speckit.companion.after-tasks.mdWhat speckit.companion.after-tasks does
This command runs python3 .specify/extensions/companion/scripts/write-context.py --hook finish --step tasks from the repository root. Its purpose is updating the task state in .spec-context.json so Companion GUI picks up the change.
Running it requires an available python3 binary. If Python is absent, state recording will fail, but the agent simply reports the issue and proceeds with the rest of the workflow.
What it helps with
- log finished tasks into
.spec-context.json - sync task status with Companion GUI
- trigger the post-task hook without breaking execution
Example prompts for the agent
- Record task completion for speckit
- Run the after-tasks hook
- Update Companion GUI task status
How to install speckit.companion.after-tasks
Manually: put the files in place
.claude/commands/speckit.companion.after-tasks.mdCall it with /speckit.companion.after-tasks. For all projects use ~/.claude/commands/
Manually: put the files in place
~/.codex/prompts/speckit.companion.after-tasks.mdCall it with /prompts:speckit.companion.after-tasks. Codex marks this format deprecated in favour of skills
Manually: put the files in place
.github/prompts/speckit.companion.after-tasks.prompt.mdManually: put the files in place
.gemini/commands/speckit.companion.after-tasks.tomlGemini stores commands as TOML: the prompt text goes into the prompt field
Questions about speckit.companion.after-tasks
How to install speckit.companion.after-tasks in Claude Code?
Place the command file at .claude/commands/speckit.companion.after-tasks.md in your repository root.
What does speckit.companion.after-tasks do?
It executes write-context.py with --hook finish --step tasks to save completion data into .spec-context.json.
What happens if python3 is missing?
The agent reports that the step was not recorded and continues without halting.
Source text
speckit.companion.after-tasks.md · MIT
--- description: "Record the tasks finish in .spec-context.json for the Companion GUI" --- # Capture Tasks Finish Run this from the repository root to record that tasks finished; if `python3` is missing, say the step was not recorded and carry on. ```bash python3 .specify/extensions/companion/scripts/write-context.py --hook finish --step tasks ```
© alfredoperez · MIT · alfredoperez/speckit-companion