Getting it into your agent
One page per mod, every tool's command on it. A separate URL per tool would split the same page into five that compete with each other.
npx agentmods add commands/anton-abyzov/specweave/pausegit clone --depth 1 https://github.com/anton-abyzov/specweaveWhat it costs to keep this loaded
Counted locally with the o200k_base tokenizer, which is exact for GPT models; Claude uses its own tokenizer and its counts differ. Treat this as one consistent yardstick across the catalogue rather than a bill. Prices are per million input tokens.
| Model | Per session | Once invoked |
|---|---|---|
| Fable 5 | $0.00000 | $0.02587 |
| Opus 5 | $0.00000 | $0.01293 |
| Sonnet 5 | $0.00000 | $0.00517 |
| Haiku 4.5 | $0.00000 | $0.00259 |
Grade A, and why
pause scanned grade A with 0 findings against 26 rules in 11 categories — prompt injection, anti-refusal, data exfiltration, privilege escalation, supply chain, agent snooping, system-prompt leakage, SSRF and excessive agency — measured 2d ago.
A static scan of the body, not an audit. Every finding is printed with the line that produced it so you can judge whether it matters here. A mod is markdown that instructs an agent; that is exactly why what it instructs is worth reading.
Nothing flagged
None of the 26 patterns this scan looks for appear in this file: no shell pipes, no recursive deletes, no credential paths, no hidden text, no instruction-override or anti-refusal phrasing, no agent-config snooping. That is not a guarantee, it is the absence of the things that are checkable.
How it starts
The opening of the file, as written. The whole thing — 428 lines — stays where its author put it; the contents beside it link to each section on GitHub.
import CommandTabs from '@site/src/components/CommandTabs';
Pause
System command used by SpecWeave to pause increments when blocked.
Synopsis
:::warning System Command This is primarily a system command used by SpecWeave internally. SpecWeave automatically pauses work when it detects blockages. You typically don't need to call this manually. :::
Description
The pause command temporarily suspends work on an active increment. SpecWeave calls this automatically when it detects you're blocked.
SpecWeave automatically pauses when:
- Missing dependencies (API keys, credentials, configuration)
- Waiting for external approvals or responses
- Persistent compilation or test failures
- You explicitly indicate "I'm blocked" or "waiting for..."
Manual pause only for:
- Business decisions (strategic pivot, deprioritization)
- Cases where SpecWeave hasn't detected blockage
Options
<increment-id> (required)
The increment to pause (e.g., 0007-payment-integration).
specweave pause 0007-payment-integration
--reason <text> or -r <text>
Reason for pausing (highly recommended).
specweave pause 0007 --reason "Waiting for Stripe production API keys"
:::warning Always Provide a Reason While optional, always provide a reason. It documents context for your future self and team. :::
--force or -f
Update reason if already paused.
# First pause
specweave pause 0007 --reason "Waiting for API keys"
# Later, update reason
specweave pause 0007 --reason "Waiting for API keys (IT ticket #1234)" --force
Examples
Example 1: Automatic Pause (Typical)
# You're working on implementation (or said "start implementing")
$ specweave do
# SpecWeave detects missing Stripe API keys
SpecWeave: I need Stripe production API keys to continue
Options:
1. Provide keys now
2. Let me pause this work and file IT ticket
3. Skip this task
# You choose option 2
$ 2
# SpecWeave automatically runs:
# specweave pause 0007-payment-integration \
# --reason "Waiting for Stripe production API keys (IT ticket #1234)"
Increment 0007-payment-integration automatically paused
Reason: Waiting for Stripe production API keys (IT ticket #1234)
No longer counts toward active limit
I've filed IT ticket #1234 for you
What this file has done since we first saw it
Hashed on every crawl. A supply-chain change to an agent config is a question of when, not whether, so the history is kept rather than the latest state alone.
- 2d ago First seen · 428 lines · 0 tokens per session scan A 5f89fe6d127c
pause is a command published in the GitHub repository anton-abyzov/specweave (159 stars, last pushed 3d ago), licensed MIT. It costs nothing until one of its globs matches a file; then it loads 2,587 tokens. A static security scan graded it A with 0 findings. No closer match exists in the catalogue, so it is treated as the original; first seen 2026-08-30.
Other commands, from other repositories
monitor-ci
Monitors pull request CI checks until they are resolved (pass or fail).
plan-regression-tests
Plan regression tests for existing code with it.skip statements.
export
Export the wiki (or architecture model) to markdown, HTML, JSON, or Structurizr DSL.
doc
Use this command to create a new feature doc, how-to, concept, reference, or troubleshooting guide — it scaffolds the file, frontmatter, structure, and sidebar entry.
review-teardown
Delete a review branch to free the shared Pantheon review slot.
dev-docs-update
Update dev documentation before context compaction.