agents-remember

Install For Codex

Codex needs two things:

1. the Agents Remember MCP server in Codex config
2. Codex-visible skills and startup instructions from the .codex/ starter package

Official references:

• Codex configuration reference
• Codex MCP
• Codex hooks
• Codex agent skills
• Codex AGENTS.md instructions

Root Starter Package

The repository includes a Codex starter package at .codex/. Copy that folder to your workspace root, then render the copied package. The .codex/render-starter script is a convenience: with a single --repo list such as --repo my-app shared-lib, it infers the workspace root from the copied .codex/ folder, fills path and repository placeholders, writes the Python hook command, and validates that each requested repository exists. If you prefer not to run the renderer, make those same replacements by hand and verify that no placeholder tokens remain. Restart Codex once after rendering.

The package contains:

• .codex/config.toml - MCP registration and SessionStart hook registration.
• .codex/hooks/agents-remember-session-start.* - startup directive emitted as session context.
• .codex/mcp/agents-remember-settings.json - Agents Remember MCP authority settings.
• .codex/skills/ - Agents Remember skills in Codex’s project skill root.

After the restart, invoke:

c-13-install-and-onboard

That skill runs or verifies runtime_install() and then handles memory, onboarding, and providers.

Workspace Instructions

Do not overwrite a repository’s root AGENTS.md just to wire Agents Remember; root AGENTS.md is project-specific. Codex can read AGENTS.md when a project already owns one, but the starter package uses the copied SessionStart hook as the first-run instruction surface.

The hook emits this directive:

# Workspace Agent Instructions

Read and follow `ar-coordination/AGENTS.md` before working in any sibling project.
Treat these rules as workspace instructions!

@ar-coordination/AGENTS.md

Use an absolute path in the @... include when the coordination runtime is outside the workspace.

The starter package already includes the Codex SessionStart hook. c-13-install-and-onboard does not install hooks during first-run setup.

Skills

The copied starter package already includes one flat folder per skill under .codex/skills/:

.codex/skills/<skill-name>/

Do not run skills_install() for first-run setup. It remains available for manual maintenance and non-package installs.

This site is open source. Improve this page.