codexmgr 0.1.2__tar.gz → 0.2.0__tar.gz

{codexmgr-0.1.2 → codexmgr-0.2.0}/.gitignore

@@ -11,5 +11,8 @@ wheels/
 AGENTS.md
 tasks.md
 .thoughts
+.brainstorm
 .plan
-.agent
+.agent
+.rules
+.docs

{codexmgr-0.1.2 → codexmgr-0.2.0}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: codexmgr
-Version: 0.1.2
+Version: 0.2.0
 Summary: Manage project-local Codex configuration from reusable templates
 Keywords: agents,cli,codex,configuration,skills
 Classifier: Development Status :: 4 - Beta
@@ -13,8 +13,10 @@ Classifier: Programming Language :: Python :: 3.13
 Classifier: Topic :: Software Development
 Classifier: Typing :: Typed
 Requires-Python: >=3.11
+Requires-Dist: textual>=8.2.7
 Requires-Dist: tomlkit>=0.15.0
 Provides-Extra: dev
+Requires-Dist: pytest-asyncio>=1.4.0; extra == 'dev'
 Requires-Dist: pytest>=9.0.3; extra == 'dev'
 Requires-Dist: pyyaml>=6.0.3; extra == 'dev'
 Description-Content-Type: text/markdown
@@ -31,7 +33,12 @@ The tool is intentionally narrow:
 
 - compose reusable AGENTS.md instruction fragments
 - enable or disable Codex skills per project
+- enable or disable reusable Codex hook bundles per project
+- enable or disable project custom agents from reusable TOML files
+- enable or disable reusable rule files copied into project-local `.rules/`
+- enable or disable packaged sets of AGENTS.md, agent, skill, hook, and rule settings
 - enable, disable, inspect, and update safe project-local MCP overrides
+- use an interactive terminal UI for common project management tasks
 - write reproducible lock data for the resolved project configuration
 - run `codex` with project `.codex/config.toml` values translated into `-c`
   overrides
@@ -95,10 +102,16 @@ This updates `.codex/codexmgr.toml`, runs `apply`, writes
 
 - `.codex/codexmgr.toml`: source configuration edited by CLI commands or by
   hand
-- `.codex/codexmgr.lock`: resolved template, skill, and MCP state written by
-  `apply`
+- `.codex/codexmgr.lock`: resolved template, agent, skill, hook, and MCP state
+  written by `apply`
 - `.codex/config.toml`: Codex config updated with `[[skills.config]]` entries
   and `[mcp_servers.<id>]` overrides
+- `.codex/hooks.json`: Codex hook config updated with enabled reusable hook
+  bundles while preserving unmanaged local hooks
+- `.codex/hooks/<name>`: project-local copies of enabled hook bundle support
+  files
+- `.codex/agents/<name>.toml`: project-local copies of enabled custom agents
+- `.rules/<path>`: project-local copies of enabled reusable rule files
 - `AGENTS.md`: project instructions, with only the managed block replaced
 
 The managed AGENTS.md block is:
@@ -113,8 +126,8 @@ Manual content outside this block is preserved. If the block is missing,
 
 ## Project Configuration
 
-`.codex/codexmgr.toml` supports AGENTS.md templates, skill state, and MCP
-overrides:
+`.codex/codexmgr.toml` supports AGENTS.md templates, custom-agent state, skill
+state, hook state, and MCP overrides:
 
 ```toml
 [agents_md]
@@ -124,6 +137,18 @@ src = ["coding", "/absolute/or/project-relative/template.toml"]
 enabled = ["review-helper"]
 disabled = ["experimental-skill", "skills/local-disabled"]
 
+[agents]
+enabled = ["rule-retriever"]
+disabled = ["experimental-agent"]
+
+[hooks]
+enabled = ["repo-rules"]
+disabled = ["experimental-hook"]
+
+[rules]
+enabled = ["react/", "python/testing.md"]
+disabled = ["react/materials/"]
+
 [mcp.servers.browsermcp]
 enabled = true
 bearer_token_env_var = "BROWSERMCP_TOKEN"
@@ -134,15 +159,101 @@ Named AGENTS.md templates resolve from `$CODEXMGR_HOME/agentsmd/<name>.toml`.
 Path-like template values resolve relative to the project unless they are
 absolute paths.
 
-Named skills resolve from `$CODEX_HOME/skills/<name>/SKILL.md`. If `CODEX_HOME`
-is unset, `~/.codex` is used. Path-like skill values resolve to either a
-`SKILL.md` file or a directory containing `SKILL.md`. Missing skills are written
-as name-based entries so Codex can resolve them later.
+Named skills resolve from `$CODEXMGR_HOME/skills/<name>/SKILL.md` or
+`$CODEX_HOME/skills/<name>/SKILL.md`; duplicate names across distinct homes
+fail. Enabled CODEXMGR_HOME skills are copied into `.agents/skills/<name>` on
+every apply by overlaying source files while preserving extra local files.
+Path-like skill values resolve to either a `SKILL.md` file or a directory
+containing `SKILL.md`. Missing skills are written as name-based entries so Codex
+can resolve them later.
+
+Named custom agents resolve from `$CODEXMGR_HOME/agents/<name>.toml`. Enabled
+agents are copied into `.codex/agents/<name>.toml` on every apply. Disabled
+agents remove their managed copy only when the lock records the file as
+codexmgr-managed.
+
+Named hooks resolve from `$CODEXMGR_HOME/hooks/<name>/hooks.json`. Enabled hook
+bundles are merged into `.codex/hooks.json` on every apply with
+`codexmanager_meta` added to each managed handler. Existing unmanaged hooks are
+preserved. Bundle files other than the root `hooks.json` are copied into
+`.codex/hooks/<name>`.
+
+Rule refs resolve under `$CODEXMGR_HOME/rules/` and are POSIX-style relative
+paths. Folder refs are stored with a trailing slash and copy all regular files
+recursively into `.rules/` while preserving relative paths. File refs copy one
+file. Extensionless refs prefer an existing `<ref>.md`. Enabled refs expand
+first, then disabled file or folder refs remove entries from that candidate set.
+First-time applies refuse to overwrite unmanaged `.rules/...` files.
+
+Packaged configurations resolve from
+`$CODEXMGR_HOME/packages/<name>/config.toml`. A package config is a TOML
+document that can contain root `agentsmd`, `agents`, `hooks`, `skills`, and `rules`
+string lists plus optional profile tables:
+
+```toml
+agentsmd = []
+agents = ["rule-retriever"]
+hooks = ["repo-rules"]
+skills = ["repo-rule-manager"]
+rules = ["react/"]
+
+[profiles.strict]
+agentsmd = ["strict-coding"]
+agents = ["strict-agent"]
+hooks = ["strict-rules"]
+skills = ["strict-review"]
+rules = ["python/testing.md"]
+```
+
+`codexmgr package enable <name>` validates package AGENTS.md and hook
+references, then updates `.codex/codexmgr.toml` as if the corresponding
+`agentsmd add`, `hooks enable`, and `skill enable` commands had been run.
+`codexmgr package disable <name>` removes package AGENTS.md entries when
+present and disables the package skills, hooks, agents, and rules.
+
+Package profiles are merged with the root package entries:
+
+```bash
+codexmgr package enable repo-rules --profile strict coding --profile python
+```
+
+Direct mutating commands also accept batch targets, for example:
+
+```bash
+codexmgr agentsmd add coding python
+codexmgr skill enable review-helper repo-rule-manager
+codexmgr hooks enable repo-rules audit
+codexmgr mcp enable browsermcp context7
+```
 
 Mutating commands run `apply` automatically unless `--no-sync` is passed.
 Project guidelines require `apply` whenever `.codex/codexmgr.toml` changes,
 unless `--no-sync` was explicitly requested.
 
+## Interactive TUI
+
+`codexmgr tui` opens a Textual-based terminal UI for managing project-local
+configuration. It shows AGENTS.md templates, skills, hooks, custom agents,
+rules, packages, and MCP server enable overrides in selectable lists. Changes are
+staged in memory while you navigate and toggle entries. Press `s` to save; the
+save writes `.codex/codexmgr.toml` once and runs `apply` once unless
+`--no-sync` was used.
+For resources with explicit enable and disable lists, `space` cycles the
+highlighted row through available, enabled, and disabled states.
+Package profiles appear as separate selectable rows under their package.
+
+```bash
+codexmgr tui
+codexmgr tui --no-sync
+codexmgr tui --show-diff
+```
+
+The dashboard shows generated-file sync state. By default it lists stale
+generated paths; with `--show-diff`, it shows unified diffs for the staged
+configuration. MCP editing in the TUI is intentionally limited to the
+project-local `enabled` override. Advanced MCP fields remain available through
+the classic `codexmgr mcp ...` commands.
+
 ## Template Format
 
 Template files are TOML documents. Each top-level key must be a table and
@@ -180,20 +291,33 @@ codexmgr apply --diff
 codexmgr cd [--path | --explorer | --terminal]
 codexmgr doctor
 codexmgr status
+codexmgr tui [--no-sync] [--show-diff]
 codexmgr agentsmd list
 codexmgr agentsmd show <name-or-template-path>
 codexmgr agentsmd validate <name-or-template-path>
-codexmgr agentsmd add [--no-sync] <name-or-template-path>
-codexmgr agentsmd remove [--no-sync] <name-or-template-path>
+codexmgr agentsmd add [--no-sync] <name-or-template-path> [...]
+codexmgr agentsmd remove [--no-sync] <name-or-template-path> [...]
 codexmgr init-template agentsmd <name>
 codexmgr skill list
-codexmgr skill enable [--no-sync] <name-or-skill-path>
-codexmgr skill disable [--no-sync] <name-or-skill-path>
+codexmgr skill enable [--no-sync] <name-or-skill-path> [...]
+codexmgr skill disable [--no-sync] <name-or-skill-path> [...]
+codexmgr agents list
+codexmgr agents enable [--no-sync] <agent-name> [...]
+codexmgr agents disable [--no-sync] <agent-name> [...]
+codexmgr hooks list
+codexmgr hooks enable [--no-sync] <hook-name> [...]
+codexmgr hooks disable [--no-sync] <hook-name> [...]
+codexmgr rules list
+codexmgr rules enable [--no-sync] <rule-ref> [...]
+codexmgr rules disable [--no-sync] <rule-ref> [...]
+codexmgr package list
+codexmgr package enable [--no-sync] <package-name> [...] [--profile <name> [...]]
+codexmgr package disable [--no-sync] <package-name> [...] [--profile <name> [...]]
 codexmgr mcp list
 codexmgr mcp show <server-id>
 codexmgr mcp validate
-codexmgr mcp enable [--no-sync] <server-id>
-codexmgr mcp disable [--no-sync] <server-id>
+codexmgr mcp enable [--no-sync] <server-id> [...]
+codexmgr mcp disable [--no-sync] <server-id> [...]
 codexmgr mcp set-token-env [--no-sync] <server-id> <ENV_VAR>
 codexmgr mcp add-env-var [--no-sync] <server-id> <ENV_VAR>
 codexmgr mcp remove-env-var [--no-sync] <server-id> <ENV_VAR>
@@ -207,9 +331,12 @@ codexmgr codex <args...>
 
 `apply` reads `.codex/codexmgr.toml`, resolves configured sources, writes
 `.codex/codexmgr.lock`, updates `.codex/config.toml` skill entries when a
-`[skills]` table is configured, writes local `[mcp_servers.<id>]` overrides when
-`[mcp]` is configured, and refreshes the generated `AGENTS.md` block when
-`[agents_md]` is configured.
+`[skills]` table is configured, copies `.codex/agents/<name>.toml` files when
+`[agents]` is configured, writes `.codex/hooks.json` when `[hooks]` is
+configured, copies `.rules/<path>` files when `[rules]` is configured, writes
+local `[mcp_servers.<id>]` overrides when `[mcp]` is
+configured, and refreshes the generated `AGENTS.md` block when `[agents_md]` is
+configured.
 
 `apply --check` exits with a failure if generated files are out of sync without
 writing them. `apply --diff` also avoids writing and prints unified diffs for
@@ -221,10 +348,19 @@ the directory in a file explorer, and `codexmgr cd --terminal` to open a new
 terminal there.
 
 `doctor` checks project setup, home environment variables, project TOML syntax,
-referenced snippets, enabled skills, and stale generated files.
+referenced snippets, enabled skills, enabled custom agents, enabled hook
+bundles, enabled rules, and stale generated files.
+
+`status` prints the resolved homes, configured snippets, skills, custom agents,
+hooks, rules, and whether generated files are in sync.
 
-`status` prints the resolved homes, configured snippets and skills, and whether
-generated files are in sync.
+`codexmgr codex` can run with a just-in-time package/profile overlay without
+changing `.codex/codexmgr.toml`. Put Codex arguments after `--` when using this
+syntax:
+
+```bash
+codexmgr codex repo-rules --profile strict coding --profile python -- exec "review this"
+```
 
 ## Project MCP Overrides
 
@@ -302,12 +438,36 @@ is not present.
 `init-template agentsmd` creates a starter template under
 `$CODEXMGR_HOME/agentsmd` and refuses to overwrite an existing template.
 
-`skill list` prints available `$CODEX_HOME/skills/*/SKILL.md` entries and marks
-configured skills as enabled, disabled, or missing.
+`skill list` prints available `$CODEXMGR_HOME/skills/*/SKILL.md`,
+`$CODEX_HOME/skills/*/SKILL.md`, and local `.agents/skills/*/SKILL.md` entries
+and marks configured skills as enabled, disabled, or missing.
 
 `skill enable` and `skill disable` keep enabled and disabled lists mutually
 exclusive. Repeated commands keep one entry.
 
+`hooks list` prints available `$CODEXMGR_HOME/hooks/*/hooks.json` entries and
+marks configured hook bundles as enabled, disabled, or missing.
+
+`hooks enable` validates that the named hook bundle exists before writing
+config. `hooks enable` and `hooks disable` keep enabled and disabled lists
+mutually exclusive. Repeated commands keep one entry.
+
+`rules list` prints available `$CODEXMGR_HOME/rules/**` files and folders and
+marks configured rule refs as enabled, disabled, or missing.
+
+`rules enable` validates and canonicalizes refs before writing config.
+`rules disable` canonicalizes existing refs and permits missing exclusions.
+Enabled and disabled lists are exact-ref mutually exclusive, so parent enables
+and child disables can intentionally coexist.
+
+`package list` prints available `$CODEXMGR_HOME/packages/*/config.toml`
+entries in sorted order.
+
+`package enable` and `package disable` proxy to existing AGENTS.md, custom-agent,
+skill, hook, and rule project-config mutations. Package state is not tracked
+separately; the resulting `[agents_md]`, `[agents]`, `[skills]`, `[hooks]`, and `[rules]`
+tables remain the source of truth.
+
 `codex` forwards arguments to the real `codex` command. Values from
 `.codex/config.toml` are flattened into `-c key=value` overrides. User-provided
 `-c` or `--config` overrides are merged after project config: scalar values

{codexmgr-0.1.2 → codexmgr-0.2.0}/README.md

@@ -10,7 +10,12 @@ The tool is intentionally narrow:
 
 - compose reusable AGENTS.md instruction fragments
 - enable or disable Codex skills per project
+- enable or disable reusable Codex hook bundles per project
+- enable or disable project custom agents from reusable TOML files
+- enable or disable reusable rule files copied into project-local `.rules/`
+- enable or disable packaged sets of AGENTS.md, agent, skill, hook, and rule settings
 - enable, disable, inspect, and update safe project-local MCP overrides
+- use an interactive terminal UI for common project management tasks
 - write reproducible lock data for the resolved project configuration
 - run `codex` with project `.codex/config.toml` values translated into `-c`
   overrides
@@ -74,10 +79,16 @@ This updates `.codex/codexmgr.toml`, runs `apply`, writes
 
 - `.codex/codexmgr.toml`: source configuration edited by CLI commands or by
   hand
-- `.codex/codexmgr.lock`: resolved template, skill, and MCP state written by
-  `apply`
+- `.codex/codexmgr.lock`: resolved template, agent, skill, hook, and MCP state
+  written by `apply`
 - `.codex/config.toml`: Codex config updated with `[[skills.config]]` entries
   and `[mcp_servers.<id>]` overrides
+- `.codex/hooks.json`: Codex hook config updated with enabled reusable hook
+  bundles while preserving unmanaged local hooks
+- `.codex/hooks/<name>`: project-local copies of enabled hook bundle support
+  files
+- `.codex/agents/<name>.toml`: project-local copies of enabled custom agents
+- `.rules/<path>`: project-local copies of enabled reusable rule files
 - `AGENTS.md`: project instructions, with only the managed block replaced
 
 The managed AGENTS.md block is:
@@ -92,8 +103,8 @@ Manual content outside this block is preserved. If the block is missing,
 
 ## Project Configuration
 
-`.codex/codexmgr.toml` supports AGENTS.md templates, skill state, and MCP
-overrides:
+`.codex/codexmgr.toml` supports AGENTS.md templates, custom-agent state, skill
+state, hook state, and MCP overrides:
 
 ```toml
 [agents_md]
@@ -103,6 +114,18 @@ src = ["coding", "/absolute/or/project-relative/template.toml"]
 enabled = ["review-helper"]
 disabled = ["experimental-skill", "skills/local-disabled"]
 
+[agents]
+enabled = ["rule-retriever"]
+disabled = ["experimental-agent"]
+
+[hooks]
+enabled = ["repo-rules"]
+disabled = ["experimental-hook"]
+
+[rules]
+enabled = ["react/", "python/testing.md"]
+disabled = ["react/materials/"]
+
 [mcp.servers.browsermcp]
 enabled = true
 bearer_token_env_var = "BROWSERMCP_TOKEN"
@@ -113,15 +136,101 @@ Named AGENTS.md templates resolve from `$CODEXMGR_HOME/agentsmd/<name>.toml`.
 Path-like template values resolve relative to the project unless they are
 absolute paths.
 
-Named skills resolve from `$CODEX_HOME/skills/<name>/SKILL.md`. If `CODEX_HOME`
-is unset, `~/.codex` is used. Path-like skill values resolve to either a
-`SKILL.md` file or a directory containing `SKILL.md`. Missing skills are written
-as name-based entries so Codex can resolve them later.
+Named skills resolve from `$CODEXMGR_HOME/skills/<name>/SKILL.md` or
+`$CODEX_HOME/skills/<name>/SKILL.md`; duplicate names across distinct homes
+fail. Enabled CODEXMGR_HOME skills are copied into `.agents/skills/<name>` on
+every apply by overlaying source files while preserving extra local files.
+Path-like skill values resolve to either a `SKILL.md` file or a directory
+containing `SKILL.md`. Missing skills are written as name-based entries so Codex
+can resolve them later.
+
+Named custom agents resolve from `$CODEXMGR_HOME/agents/<name>.toml`. Enabled
+agents are copied into `.codex/agents/<name>.toml` on every apply. Disabled
+agents remove their managed copy only when the lock records the file as
+codexmgr-managed.
+
+Named hooks resolve from `$CODEXMGR_HOME/hooks/<name>/hooks.json`. Enabled hook
+bundles are merged into `.codex/hooks.json` on every apply with
+`codexmanager_meta` added to each managed handler. Existing unmanaged hooks are
+preserved. Bundle files other than the root `hooks.json` are copied into
+`.codex/hooks/<name>`.
+
+Rule refs resolve under `$CODEXMGR_HOME/rules/` and are POSIX-style relative
+paths. Folder refs are stored with a trailing slash and copy all regular files
+recursively into `.rules/` while preserving relative paths. File refs copy one
+file. Extensionless refs prefer an existing `<ref>.md`. Enabled refs expand
+first, then disabled file or folder refs remove entries from that candidate set.
+First-time applies refuse to overwrite unmanaged `.rules/...` files.
+
+Packaged configurations resolve from
+`$CODEXMGR_HOME/packages/<name>/config.toml`. A package config is a TOML
+document that can contain root `agentsmd`, `agents`, `hooks`, `skills`, and `rules`
+string lists plus optional profile tables:
+
+```toml
+agentsmd = []
+agents = ["rule-retriever"]
+hooks = ["repo-rules"]
+skills = ["repo-rule-manager"]
+rules = ["react/"]
+
+[profiles.strict]
+agentsmd = ["strict-coding"]
+agents = ["strict-agent"]
+hooks = ["strict-rules"]
+skills = ["strict-review"]
+rules = ["python/testing.md"]
+```
+
+`codexmgr package enable <name>` validates package AGENTS.md and hook
+references, then updates `.codex/codexmgr.toml` as if the corresponding
+`agentsmd add`, `hooks enable`, and `skill enable` commands had been run.
+`codexmgr package disable <name>` removes package AGENTS.md entries when
+present and disables the package skills, hooks, agents, and rules.
+
+Package profiles are merged with the root package entries:
+
+```bash
+codexmgr package enable repo-rules --profile strict coding --profile python
+```
+
+Direct mutating commands also accept batch targets, for example:
+
+```bash
+codexmgr agentsmd add coding python
+codexmgr skill enable review-helper repo-rule-manager
+codexmgr hooks enable repo-rules audit
+codexmgr mcp enable browsermcp context7
+```
 
 Mutating commands run `apply` automatically unless `--no-sync` is passed.
 Project guidelines require `apply` whenever `.codex/codexmgr.toml` changes,
 unless `--no-sync` was explicitly requested.
 
+## Interactive TUI
+
+`codexmgr tui` opens a Textual-based terminal UI for managing project-local
+configuration. It shows AGENTS.md templates, skills, hooks, custom agents,
+rules, packages, and MCP server enable overrides in selectable lists. Changes are
+staged in memory while you navigate and toggle entries. Press `s` to save; the
+save writes `.codex/codexmgr.toml` once and runs `apply` once unless
+`--no-sync` was used.
+For resources with explicit enable and disable lists, `space` cycles the
+highlighted row through available, enabled, and disabled states.
+Package profiles appear as separate selectable rows under their package.
+
+```bash
+codexmgr tui
+codexmgr tui --no-sync
+codexmgr tui --show-diff
+```
+
+The dashboard shows generated-file sync state. By default it lists stale
+generated paths; with `--show-diff`, it shows unified diffs for the staged
+configuration. MCP editing in the TUI is intentionally limited to the
+project-local `enabled` override. Advanced MCP fields remain available through
+the classic `codexmgr mcp ...` commands.
+
 ## Template Format
 
 Template files are TOML documents. Each top-level key must be a table and
@@ -159,20 +268,33 @@ codexmgr apply --diff
 codexmgr cd [--path | --explorer | --terminal]
 codexmgr doctor
 codexmgr status
+codexmgr tui [--no-sync] [--show-diff]
 codexmgr agentsmd list
 codexmgr agentsmd show <name-or-template-path>
 codexmgr agentsmd validate <name-or-template-path>
-codexmgr agentsmd add [--no-sync] <name-or-template-path>
-codexmgr agentsmd remove [--no-sync] <name-or-template-path>
+codexmgr agentsmd add [--no-sync] <name-or-template-path> [...]
+codexmgr agentsmd remove [--no-sync] <name-or-template-path> [...]
 codexmgr init-template agentsmd <name>
 codexmgr skill list
-codexmgr skill enable [--no-sync] <name-or-skill-path>
-codexmgr skill disable [--no-sync] <name-or-skill-path>
+codexmgr skill enable [--no-sync] <name-or-skill-path> [...]
+codexmgr skill disable [--no-sync] <name-or-skill-path> [...]
+codexmgr agents list
+codexmgr agents enable [--no-sync] <agent-name> [...]
+codexmgr agents disable [--no-sync] <agent-name> [...]
+codexmgr hooks list
+codexmgr hooks enable [--no-sync] <hook-name> [...]
+codexmgr hooks disable [--no-sync] <hook-name> [...]
+codexmgr rules list
+codexmgr rules enable [--no-sync] <rule-ref> [...]
+codexmgr rules disable [--no-sync] <rule-ref> [...]
+codexmgr package list
+codexmgr package enable [--no-sync] <package-name> [...] [--profile <name> [...]]
+codexmgr package disable [--no-sync] <package-name> [...] [--profile <name> [...]]
 codexmgr mcp list
 codexmgr mcp show <server-id>
 codexmgr mcp validate
-codexmgr mcp enable [--no-sync] <server-id>
-codexmgr mcp disable [--no-sync] <server-id>
+codexmgr mcp enable [--no-sync] <server-id> [...]
+codexmgr mcp disable [--no-sync] <server-id> [...]
 codexmgr mcp set-token-env [--no-sync] <server-id> <ENV_VAR>
 codexmgr mcp add-env-var [--no-sync] <server-id> <ENV_VAR>
 codexmgr mcp remove-env-var [--no-sync] <server-id> <ENV_VAR>
@@ -186,9 +308,12 @@ codexmgr codex <args...>
 
 `apply` reads `.codex/codexmgr.toml`, resolves configured sources, writes
 `.codex/codexmgr.lock`, updates `.codex/config.toml` skill entries when a
-`[skills]` table is configured, writes local `[mcp_servers.<id>]` overrides when
-`[mcp]` is configured, and refreshes the generated `AGENTS.md` block when
-`[agents_md]` is configured.
+`[skills]` table is configured, copies `.codex/agents/<name>.toml` files when
+`[agents]` is configured, writes `.codex/hooks.json` when `[hooks]` is
+configured, copies `.rules/<path>` files when `[rules]` is configured, writes
+local `[mcp_servers.<id>]` overrides when `[mcp]` is
+configured, and refreshes the generated `AGENTS.md` block when `[agents_md]` is
+configured.
 
 `apply --check` exits with a failure if generated files are out of sync without
 writing them. `apply --diff` also avoids writing and prints unified diffs for
@@ -200,10 +325,19 @@ the directory in a file explorer, and `codexmgr cd --terminal` to open a new
 terminal there.
 
 `doctor` checks project setup, home environment variables, project TOML syntax,
-referenced snippets, enabled skills, and stale generated files.
+referenced snippets, enabled skills, enabled custom agents, enabled hook
+bundles, enabled rules, and stale generated files.
+
+`status` prints the resolved homes, configured snippets, skills, custom agents,
+hooks, rules, and whether generated files are in sync.
 
-`status` prints the resolved homes, configured snippets and skills, and whether
-generated files are in sync.
+`codexmgr codex` can run with a just-in-time package/profile overlay without
+changing `.codex/codexmgr.toml`. Put Codex arguments after `--` when using this
+syntax:
+
+```bash
+codexmgr codex repo-rules --profile strict coding --profile python -- exec "review this"
+```
 
 ## Project MCP Overrides
 
@@ -281,12 +415,36 @@ is not present.
 `init-template agentsmd` creates a starter template under
 `$CODEXMGR_HOME/agentsmd` and refuses to overwrite an existing template.
 
-`skill list` prints available `$CODEX_HOME/skills/*/SKILL.md` entries and marks
-configured skills as enabled, disabled, or missing.
+`skill list` prints available `$CODEXMGR_HOME/skills/*/SKILL.md`,
+`$CODEX_HOME/skills/*/SKILL.md`, and local `.agents/skills/*/SKILL.md` entries
+and marks configured skills as enabled, disabled, or missing.
 
 `skill enable` and `skill disable` keep enabled and disabled lists mutually
 exclusive. Repeated commands keep one entry.
 
+`hooks list` prints available `$CODEXMGR_HOME/hooks/*/hooks.json` entries and
+marks configured hook bundles as enabled, disabled, or missing.
+
+`hooks enable` validates that the named hook bundle exists before writing
+config. `hooks enable` and `hooks disable` keep enabled and disabled lists
+mutually exclusive. Repeated commands keep one entry.
+
+`rules list` prints available `$CODEXMGR_HOME/rules/**` files and folders and
+marks configured rule refs as enabled, disabled, or missing.
+
+`rules enable` validates and canonicalizes refs before writing config.
+`rules disable` canonicalizes existing refs and permits missing exclusions.
+Enabled and disabled lists are exact-ref mutually exclusive, so parent enables
+and child disables can intentionally coexist.
+
+`package list` prints available `$CODEXMGR_HOME/packages/*/config.toml`
+entries in sorted order.
+
+`package enable` and `package disable` proxy to existing AGENTS.md, custom-agent,
+skill, hook, and rule project-config mutations. Package state is not tracked
+separately; the resulting `[agents_md]`, `[agents]`, `[skills]`, `[hooks]`, and `[rules]`
+tables remain the source of truth.
+
 `codex` forwards arguments to the real `codex` command. Values from
 `.codex/config.toml` are flattened into `-c key=value` overrides. User-provided
 `-c` or `--config` overrides are merged after project config: scalar values

{codexmgr-0.1.2 → codexmgr-0.2.0}/pyproject.toml

@@ -1,10 +1,11 @@
 [project]
 name = "codexmgr"
-version = "0.1.2"
+version = "0.2.0"
 description = "Manage project-local Codex configuration from reusable templates"
 readme = "README.md"
 requires-python = ">=3.11"
 dependencies = [
+    "textual>=8.2.7",
     "tomlkit>=0.15.0",
 ]
 keywords = ["codex", "cli", "configuration", "agents", "skills"]
@@ -21,12 +22,13 @@ classifiers = [
 ]
 
 [project.scripts]
-codexmgr = "codexmgr.cli:entrypoint"
+codexmgr = "codexmgr.interface.cli:entrypoint"
 
 [project.optional-dependencies]
 dev = [
     "pytest>=9.0.3",
     "pyyaml>=6.0.3",
+    "pytest-asyncio>=1.4.0",
 ]
 
 [build-system]

{codexmgr-0.1.2 → codexmgr-0.2.0}/src/codexmgr/__init__.py

@@ -2,4 +2,4 @@
 
 __all__ = ["__version__"]
 
-__version__ = "0.1.2"
+__version__ = "0.2.0"

codexmgr-0.2.0/src/codexmgr/agents/__init__.py

@@ -0,0 +1 @@
+"""AGENTS.md template resolution, rendering, and managed-file packages."""

codexmgr-0.1.2/src/codexmgr/agents_file.py → codexmgr-0.2.0/src/codexmgr/agents/file.py

@@ -2,7 +2,7 @@
 
 from pathlib import Path
 
-from .errors import CommandError
+from ..core.errors import CommandError
 
 BEGIN_MARKER = "<!-- BEGIN CODEXMGR GENERATED -->"
 END_MARKER = "<!-- END CODEXMGR GENERATED -->"

codexmgr-0.1.2/src/codexmgr/agentsmd.py → codexmgr-0.2.0/src/codexmgr/agents/manager.py

@@ -3,18 +3,18 @@
 from pathlib import Path
 from typing import Any
 
-from .agents_file import write_managed_agents_md
-from .errors import CommandError
-from .options import list_toml_options
-from .paths import agents_md_path, config_path, resolve_template
-from .project_config import (
+from .file import write_managed_agents_md
+from .renderer import render_agents_markdown
+from ..core.errors import CommandError
+from ..core.options import list_toml_options
+from ..core.paths import agents_md_path, config_path, resolve_template
+from ..core.toml_io import load_optional_toml_file, load_toml_file, write_toml_file
+from ..project.config import (
     agents_md_sources,
     load_required_project_config,
     require_codex_dir,
     set_agents_md_sources,
 )
-from .renderer import render_agents_markdown
-from .toml_io import load_optional_toml_file, load_toml_file, write_toml_file
 
 
 def add_agentsmd(reference: str, cwd: Path, codexmgr_home: Path) -> str: