Skip to main content
subagent CX Codex

context-manager · voltagent/awesome-codex-subagents — Codex subagent: what it does, how to install

context-manager builds a short project brief that other subagents read before starting deeper work.

MIT ★ 6,505 updated 2026-10-05

Install into Codex · Manually: put the files in place All methods and platforms ↓
.codex/agents/context-manager.toml
Open on GitHub

What context-manager does

It reads the repo and packs what a delegate needs before deeper work: module boundaries, entry points, data flow, coding conventions. Four steps follow — map the architecture, pull constraints and invariants out of the code, squeeze them into a small packet with file and symbol anchors, then flag unknowns that could change the plan.

Output splits into architecture, constraints and risks. Alongside come the key files and why they matter, assumptions marked as inferred or confirmed, open questions with an order for checking them, and handoff notes for building the delegate prompt. The frontmatter sets the model to gpt-5.6-luna; the agent file lives at .codex/agents/context-manager.toml.

Wide repo tours are not the job. Anything that does not feed a decision gets dropped unless the parent agent asks for it, so this will not replace a first pass through an unfamiliar codebase — it briefs someone for a specific task.

What it helps with

  • brief another subagent on an unfamiliar repository
  • write down coding conventions and constraints before delegating
  • list unknowns that could change the execution plan
  • compress project detail into a packet with file and symbol anchors
  • separate confirmed facts from inferred assumptions

Example prompts for the agent

  • Run context-manager and brief me on src/api before I delegate.
  • Prepare a context packet for the reviewer subagent: key files, conventions, risks.
  • Compress this task into a packet and tell me what is still unverified.

How to install context-manager

Manually: put the files in place

.codex/agents/context-manager.toml

Codex defines subagents in TOML: name, description, developer_instructions. Move the Markdown text into developer_instructions by hand. For all projects use ~/.codex/agents/

Step by step, with commands for each platform: Claude Code subagents: how to create one, call it and keep context clean

Questions about context-manager

How do I install context-manager in Codex?

Place the agent file at .codex/agents/context-manager.toml in your project.

What does context-manager do?

It surveys the repository and returns a small context packet: architecture, constraints, risks and open questions for the next subagent.

Which model is set in the configuration?

The frontmatter names gpt-5.6-luna.

Source text

context-manager.toml · MIT
# context-manager

Use when a task needs a compact project context summary that other subagents can rely on before deeper work begins.

Own context packaging as signal curation for downstream subagents.

Produce compact, execution-ready context that improves delegate accuracy while avoiding noise and speculative assumptions.

Working mode:
1. Map task-relevant architecture, modules, and ownership boundaries.
2. Extract constraints, conventions, and invariants from repository evidence.
3. Compress into a minimal packet with file/symbol anchors and open questions.
4. Highlight unknowns that can change execution strategy.

Focus on:
- relevant entry points, data flow, and integration boundaries
- coding patterns and architectural conventions that delegates should preserve
- environment and tooling assumptions visible in the codebase
- known constraints (security, performance, compatibility, release process)
- terminology normalization to reduce cross-thread misunderstanding
- omission of irrelevant repo detail that creates context bloat
- uncertainty tracking for unresolved design or runtime facts

Quality checks:
- verify each context item directly supports delegated task decisions
- confirm references include concrete files/symbols when available
- check assumptions are clearly marked as inferred vs confirmed
- ensure packet is compact enough for fast delegate onboarding
- call out missing evidence that requires explicit discovery work

Return:
- concise context packet organized by architecture, constraints, and risks
- key files/symbols and why they matter
- explicit assumptions and confidence level
- unresolved unknowns and suggested discovery order
- handoff notes for delegate prompt construction

Do not include broad repository summaries that are not decision-relevant unless explicitly requested by the parent agent.

© VoltAgent · MIT · VoltAgent/awesome-codex-subagents

Similar subagents

All subagents for Agent setup: memory, context, orchestration →

context-manager by other authors comes first.

context-manager VoltAgent Community context-manager organizes shared context for multi-agent projects in files, including state, task history, and decisions. Use it when agents need a clear shared workspace. CX Codex 10,638installs context-manager rohitg00 The context-manager subagent decides what to load into the context window and what to summarize when space runs short. It helps keep task-specific code and decisions in view. CX Codex ★ 2,858repo stars context-engineering-collection muratcankoylan context-engineering-collection is a Claude Code skill with patterns for context management, multi-agent systems, and long-running loops for reliable autonomous systems. CX Codex +1 4,500installs context-synthesizer ruvnet context-synthesizer synthesizes multidimensional context across task constraints, domain patterns, and past execution memory. Helps maintain clear situational awareness during complex execution. CX Codex ★ 850repo stars agent-startup-and-context-ingestion mvschwarz agent-startup-and-context-ingestion is a Claude Code skill for shaping an agent’s startup context and checking whether its guidance is current. It applies when creating or revising startup files and passing work to another agent. CX Codex +1 ★ 8,928repo stars bmad-project-context bmad-code-org bmad-project-context is a Claude Code skill that builds, audits, and maintains verified agent instructions in AGENTS.md. It records past agent mistakes as explicit pitfalls. CX Codex +1 17,200installs maintaining-agent-context sentimony maintaining-agent-context audits the instruction files a repo hands to coding agents, catching duplicates, contradictions and wasted always-loaded tokens. CX Codex +1 3,200installs domain-context ryan-price domain-context maintains a domain knowledge base in .tasks/domain.md across sessions. Tracks internal terms, entity relationships, and core business rules. CX Codex +1 2,700installs

From the same set176

The whole set →
multi-agent-coordinator The multi-agent-coordinator subagent divides work between the parent agent and parallel delegates, sets ownership boundaries, and plans how results come together. Use it for tasks with separable workstreams. CX Codex ★ 6,505repo stars knowledge-synthesizer knowledge-synthesizer merges reports from several agents into one picture: what is confirmed, where findings disagree, and what to do next. CX Codex ★ 6,505repo stars it-ops-orchestrator it-ops-orchestrator coordinates complex operational planning across infrastructure, identity, endpoints, and incident response teams. CX Codex ★ 6,505repo stars error-coordinator error-coordinator groups multiple errors by likely cause, sets investigation priorities, and routes each cluster to a suitable specialist. Use it when symptoms pile up and the first fault is unclear. CX Codex ★ 6,505repo stars codebase-orchestrator codebase-orchestrator — a Codex subagent for repository-wide refactoring with risk prioritization, diff previews, and mandatory human approval gates. CX Codex ★ 6,505repo stars agent-organizer The agent-organizer subagent helps a parent agent split large work into bounded threads, choose what to delegate, and coordinate the results. CX Codex ★ 6,505repo stars agent-installer agent-installer — a subagent that selects, copies and organizes custom agents from the repository into Codex directories. Plans installation scope, detects naming conflicts and checks dependencies before setup. CX Codex ★ 6,505repo stars wordpress-master wordpress-master handles WordPress implementation and debugging across themes, plugins, and operational site workflows. CX Codex ★ 6,505repo stars

Project sponsors

Companies that keep this analytics open