| name | ctx-agent |
| description | Load full context packet. Use at session start or when context seems stale or incomplete. |
Load the full context packet for AI consumption.
When to Use
- At the start of a session to load all context
- When context seems stale or incomplete
- When switching between different areas of work
When NOT to Use
- The PreToolUse hook already runs
ctx agent automatically with a cooldown:
you rarely need to invoke this manually
- Don't run it just to "refresh" if you already have the context loaded in
this session
After Loading
Read the files listed in "Read These Files (in order)": the packet is a
summary, not a substitute. In particular, read CONVENTIONS.md before writing
any code.
Confirm to the user: "I have read the required context files and I'm
following project conventions." Read and confirm before beginning
implementation.
Flags
| Flag | Default | Description |
|---|
--budget | 8000 | Token budget for context packet |
--format | md | Output format: md or json |
--cooldown | 10m | Suppress repeated output within this duration |
--session | (none) | Session ID for cooldown isolation (e.g., $PPID) |
Execution
ctx agent $ARGUMENTS
Example: default load:
ctx agent
Example: smaller packet for limited contexts:
ctx agent --budget 4000
Example: with cooldown (how the PreToolUse hook invokes it):
ctx agent --budget 4000 --session $PPID
Example: JSON for programmatic use:
ctx agent --format json --budget 8000
