codexmgr 0.1.2__tar.gz → 0.1.3__tar.gz

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

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

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

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: codexmgr
-Version: 0.1.2
+Version: 0.1.3
 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,10 @@ 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 packaged sets of AGENTS.md, skill, and hook 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 +100,14 @@ 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
+- `.codex/codexmgr.lock`: resolved template, 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
 - `AGENTS.md`: project instructions, with only the managed block replaced
 
 The managed AGENTS.md block is:
@@ -113,7 +122,7 @@ 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
+`.codex/codexmgr.toml` supports AGENTS.md templates, skill state, hook state, and MCP
 overrides:
 
 ```toml
@@ -124,6 +133,10 @@ src = ["coding", "/absolute/or/project-relative/template.toml"]
 enabled = ["review-helper"]
 disabled = ["experimental-skill", "skills/local-disabled"]
 
+[hooks]
+enabled = ["repo-rules"]
+disabled = ["experimental-hook"]
+
 [mcp.servers.browsermcp]
 enabled = true
 bearer_token_env_var = "BROWSERMCP_TOKEN"
@@ -134,15 +147,82 @@ 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 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>`.
+
+Packaged configurations resolve from
+`$CODEXMGR_HOME/packages/<name>/config.toml`. A package config is a TOML
+document that can contain root `agentsmd`, `hooks`, and `skills` string lists
+plus optional profile tables:
+
+```toml
+agentsmd = []
+hooks = ["repo-rules"]
+skills = ["repo-rule-manager"]
+
+[profiles.strict]
+agentsmd = ["strict-coding"]
+hooks = ["strict-rules"]
+skills = ["strict-review"]
+```
+
+`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 and hooks.
+
+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, 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.
+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 +260,27 @@ 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 hooks list
+codexmgr hooks enable [--no-sync] <hook-name> [...]
+codexmgr hooks disable [--no-sync] <hook-name> [...]
+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 +294,10 @@ 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, writes `.codex/hooks.json` when `[hooks]` 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 +309,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 hook bundles, and stale generated
+files.
+
+`status` prints the resolved homes, configured snippets, skills, hooks, 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 +399,28 @@ 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.
+
+`package list` prints available `$CODEXMGR_HOME/packages/*/config.toml`
+entries in sorted order.
+
+`package enable` and `package disable` proxy to existing AGENTS.md, skill, and
+hook project-config mutations. Package state is not tracked separately; the
+resulting `[agents_md]`, `[skills]`, and `[hooks]` 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.1.3}/README.md

@@ -10,7 +10,10 @@ 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 packaged sets of AGENTS.md, skill, and hook 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 +77,14 @@ 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
+- `.codex/codexmgr.lock`: resolved template, 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
 - `AGENTS.md`: project instructions, with only the managed block replaced
 
 The managed AGENTS.md block is:
@@ -92,7 +99,7 @@ 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
+`.codex/codexmgr.toml` supports AGENTS.md templates, skill state, hook state, and MCP
 overrides:
 
 ```toml
@@ -103,6 +110,10 @@ src = ["coding", "/absolute/or/project-relative/template.toml"]
 enabled = ["review-helper"]
 disabled = ["experimental-skill", "skills/local-disabled"]
 
+[hooks]
+enabled = ["repo-rules"]
+disabled = ["experimental-hook"]
+
 [mcp.servers.browsermcp]
 enabled = true
 bearer_token_env_var = "BROWSERMCP_TOKEN"
@@ -113,15 +124,82 @@ 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 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>`.
+
+Packaged configurations resolve from
+`$CODEXMGR_HOME/packages/<name>/config.toml`. A package config is a TOML
+document that can contain root `agentsmd`, `hooks`, and `skills` string lists
+plus optional profile tables:
+
+```toml
+agentsmd = []
+hooks = ["repo-rules"]
+skills = ["repo-rule-manager"]
+
+[profiles.strict]
+agentsmd = ["strict-coding"]
+hooks = ["strict-rules"]
+skills = ["strict-review"]
+```
+
+`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 and hooks.
+
+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, 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.
+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 +237,27 @@ 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 hooks list
+codexmgr hooks enable [--no-sync] <hook-name> [...]
+codexmgr hooks disable [--no-sync] <hook-name> [...]
+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 +271,10 @@ 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, writes `.codex/hooks.json` when `[hooks]` 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 +286,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 hook bundles, and stale generated
+files.
+
+`status` prints the resolved homes, configured snippets, skills, hooks, 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 +376,28 @@ 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.
+
+`package list` prints available `$CODEXMGR_HOME/packages/*/config.toml`
+entries in sorted order.
+
+`package enable` and `package disable` proxy to existing AGENTS.md, skill, and
+hook project-config mutations. Package state is not tracked separately; the
+resulting `[agents_md]`, `[skills]`, and `[hooks]` 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.1.3}/pyproject.toml

@@ -1,10 +1,11 @@
 [project]
 name = "codexmgr"
-version = "0.1.2"
+version = "0.1.3"
 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.1.3}/src/codexmgr/__init__.py

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

codexmgr-0.1.3/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.1.3/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.1.3/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:

{codexmgr-0.1.2/src/codexmgr → codexmgr-0.1.3/src/codexmgr/agents}/renderer.py

@@ -5,7 +5,7 @@ from collections.abc import Mapping
 from dataclasses import dataclass, field
 from typing import Any
 
-from .errors import CommandError
+from ..core.errors import CommandError
 
 
 @dataclass

codexmgr-0.1.3/src/codexmgr/commands/__init__.py

@@ -0,0 +1 @@
+"""Command implementations for CLI-facing codexmgr features."""

{codexmgr-0.1.2/src/codexmgr → codexmgr-0.1.3/src/codexmgr/commands}/codex.py

@@ -6,9 +6,36 @@ from collections.abc import Mapping
 from pathlib import Path
 from typing import Any
 
-from .errors import CommandError
-from .paths import codex_config_path
-from .toml_io import format_toml_value, load_optional_toml_file
+from ..core.errors import CommandError
+from ..core.paths import codex_config_path
+from ..core.toml_io import format_toml_value, load_optional_toml_file
+from .codex_jit import parse_codex_jit_request, run_with_jit_overlay
+
+
+def run_codex_command(
+    cwd: Path,
+    codex_home: Path,
+    codexmgr_home: Path,
+    codex_args: list[str],
+) -> int:
+    """Apply project config and run Codex, optionally with a JIT overlay.
+
+    Args:
+        cwd: Project working directory for the external Codex process.
+        codex_home: Codex home used to resolve project skills.
+        codexmgr_home: codexmgr home containing package sources.
+        codex_args: Raw arguments after ``codexmgr codex``.
+
+    Returns:
+        The external Codex process return code.
+    """
+    request = parse_codex_jit_request(codex_args)
+    if request.enabled:
+        return run_with_jit_overlay(request, cwd, codex_home, codexmgr_home, run_codex)
+    from ..project.apply import apply_project_config
+
+    apply_project_config(cwd, codex_home, codexmgr_home)
+    return run_codex(cwd, codex_args)
 
 
 def run_codex(cwd: Path, codex_args: list[str]) -> int: