codexkit 1.0.0

package/templates/global/.codex-config-template.toml

@@ -0,0 +1,87 @@
+# Codexkit — Global Shared Configuration
+# Installs to ~/.codex/config.toml
+# Shared profiles, agents, and feature defaults live here.
+
+[profiles.default]
+model = "gpt-5.3-codex"
+sandbox_mode = "workspace-write"
+approval_policy = "on-request"
+
+[profiles.explore]
+model = "gpt-5.3-codex"
+sandbox_mode = "read-only"
+approval_policy = "never"
+
+[profiles.plan]
+model = "gpt-5.4"
+sandbox_mode = "read-only"
+approval_policy = "never"
+
+[profiles.build]
+model = "gpt-5.3-codex"
+sandbox_mode = "workspace-write"
+approval_policy = "on-request"
+
+[profiles.review]
+model = "gpt-5.4"
+sandbox_mode = "read-only"
+approval_policy = "never"
+
+[profiles.ship]
+model = "gpt-5.3-codex"
+sandbox_mode = "workspace-write"
+approval_policy = "on-request"
+
+[agents]
+max_threads = 6
+max_depth = 1
+
+[agents.planner]
+description = "Plans implementation approach with goal-backward decomposition before coding begins."
+config_file = "./agents/planner.toml"
+
+[agents.reviewer]
+description = "Reviews code quality, correctness, security, and test coverage."
+config_file = "./agents/reviewer.toml"
+
+[agents.shipper]
+description = "Prepares and validates code for shipping — PR prep, changelog, final verification."
+config_file = "./agents/shipper.toml"
+
+[agents.scout]
+description = "Research specialist for library docs, API references, and external patterns."
+config_file = "./agents/scout.toml"
+
+[agents.vision]
+description = "Visual analysis specialist for UI/UX review, accessibility audits, and design consistency."
+config_file = "./agents/vision.toml"
+
+[agents.debugger]
+description = "Bug investigation specialist — finds root causes through systematic hypothesis testing."
+config_file = "./agents/debugger.toml"
+
+[agents.refactorer]
+description = "Safe refactoring specialist — improves code structure while preserving behavior."
+config_file = "./agents/refactorer.toml"
+
+[agents.builder]
+description = "Primary implementation agent — writes production code with verification and deviation rules."
+config_file = "./agents/builder.toml"
+
+[agents.runner]
+description = "Lightweight shell, git, and filesystem operations for scoped execution tasks."
+config_file = "./agents/runner.toml"
+
+[agents.general]
+description = "Small, well-defined implementation subtasks with limited scope."
+config_file = "./agents/general.toml"
+
+[agents.painter]
+description = "Image generation and visual asset planning specialist."
+config_file = "./agents/painter.toml"
+
+[history]
+persistence = "save-all"
+
+[features]
+multi_agent = true

package/templates/global/AGENTS.override.md

@@ -0,0 +1,18 @@
+# Personal Overrides
+
+> Override project AGENTS.md rules for personal preferences.
+> Place this file at ~/.codex/AGENTS.override.md
+
+## Preferences
+
+- [Add your personal coding preferences here]
+- [Example: "Prefer functional programming patterns"]
+- [Example: "Always add JSDoc comments"]
+
+## Model Preferences
+
+- [Example: "Use gpt-5.4 for all planning tasks"]
+
+## Additional Skills
+
+- [List any custom skills you want always available]

package/templates/global/README.md

@@ -0,0 +1,29 @@
+# Global Templates
+
+These files install to `~/.codex/` (user-level configuration).
+
+## Purpose
+
+- Contains user-level `AGENTS.md` overrides
+- Shared Codex profiles, agents, prompts, and skills
+- Personal preferences and global settings
+- Applied across all projects unless overridden at project level
+
+## Contents
+
+| File | Description |
+|---|---|
+| `AGENTS.override.md` | Personal AGENTS.md override template |
+| `.codex-config-template.toml` | Shared root config template for `~/.codex/config.toml` |
+
+## Installation
+
+```bash
+./install/install-global.sh
+```
+
+Or with `--force` to overwrite existing files:
+
+```bash
+./install/install-global.sh --force
+```

package/templates/project/.codex-config-template.toml

@@ -0,0 +1,26 @@
+# Codexkit — Project-Scoped Configuration
+# Shared profiles, prompts, skills, and agent registrations can live in ~/.codex/.
+# Keep project-local config focused on hooks and project-specific tool wiring.
+
+[project]
+name = "[PROJECT_NAME]"
+
+[[hooks]]
+event = "AfterAgent"
+command = ".codex/hooks/after_agent.sh"
+
+[[hooks]]
+event = "AfterToolUse"
+command = ".codex/hooks/after_tool_use.sh"
+
+[mcp_servers.tilth]
+command = "npx"
+args = ["-y", "tilth", "--mcp", "--edit"]
+startup_timeout_sec = 30.0
+tool_timeout_sec = 60.0
+
+[history]
+persistence = "save-all"
+
+[features]
+multi_agent = true

package/templates/project/AGENTS.md.template

@@ -0,0 +1,27 @@
+# [Project Name] — Operating Rules
+
+## Tech Stack
+- Language: [FILL IN]
+- Framework: [FILL IN]
+- Package Manager: [FILL IN]
+
+## Commands
+| Command | Purpose |
+|---|---|
+| `[FILL IN]` | Build |
+| `[FILL IN]` | Test |
+| `[FILL IN]` | Lint |
+
+## Code Example
+```[language]
+// Representative code pattern from this project
+[FILL IN]
+```
+
+## Boundaries
+### Always
+- [FILL IN]
+### Ask First
+- [FILL IN]
+### Never
+- [FILL IN]

package/templates/project/README.md

@@ -0,0 +1,24 @@
+# Project Templates
+
+These files install to `<repo>/` (project-level).
+
+## Purpose
+
+- Contains project-specific `AGENTS.md` configuration
+- `.codex/` config directory structure
+- Context docs for project knowledge
+
+## Contents
+
+| File | Description |
+|---|---|
+| `.codex-config-template.toml` | Minimal project config (copies to `.codex/config.toml`) |
+| `AGENTS.md.template` | Project AGENTS.md template (copies to repo root) |
+
+## Installation
+
+From your project root:
+
+```bash
+/path/to/codexkit/install/install-project.sh
+```