@skastr0/atlas-codex-plugin
v0.1.2
Published
Codex lifecycle hooks for keeping Atlas indexes refreshed during sessions
Downloads
52
Maintainers
Readme
Atlas Codex plugin
This package is the Codex equivalent of the OpenCode Atlas plugin.
Install the atlas CLI separately with cargo install agent-atlas. For normal use, install the same version of the CLI and this plugin package.
Codex currently exposes installable plugin bundles and lifecycle command hooks, not a long-lived TypeScript server plugin API like OpenCode. This plugin therefore implements the closest supported behavior:
SessionStartforstartup,resume, andclearrunsatlas init --root "$root" --quietwhenatlasis onPATH.PostToolUsefor Codex edit tools (apply_patch,Edit,Write) runsatlas build --root "$root" --changed-onlywhenatlasis onPATHand.atlasexists.$rootis the git worktree root whengit rev-parse --show-toplevelsucceeds, otherwise the Codex session cwd.
The OpenCode plugin also debounces file-change events in-process. Codex lifecycle hooks are command invocations, so this plugin refreshes after each supported edit hook instead of maintaining a debounced background fiber.
Local development
node --test apps/codex-plugin/test/hooks.test.mjsInstall from the repo marketplace
This repository includes .agents/plugins/marketplace.json, which points at apps/codex-plugin.
For a local checkout:
codex plugin marketplace add /path/to/atlas
codex plugin add atlas@atlas-localFor a Git-backed marketplace snapshot:
codex plugin marketplace add skastr0/atlas --ref main
codex plugin add atlas@atlas-localAfter adding or updating the marketplace in Codex, restart Codex and install the atlas plugin from the plugin browser or CLI. Codex installs local plugins into its plugin cache, so restart Codex after changing this package during development.
Codex hooks must be enabled in the active config:
[features]
codex_hooks = true