{"id":50138891,"url":"https://github.com/casoon/ai-agent-config","last_synced_at":"2026-05-24T00:03:34.186Z","repository":{"id":352823917,"uuid":"1216781204","full_name":"casoon/ai-agent-config","owner":"casoon","description":"Shareable baseline configuration for Claude Code and Codex — global instructions, subagents, and skills in a single tree, symlinked into each tool's config dir.","archived":false,"fork":false,"pushed_at":"2026-05-20T14:05:37.000Z","size":71,"stargazers_count":0,"open_issues_count":0,"forks_count":0,"subscribers_count":0,"default_branch":"main","last_synced_at":"2026-05-20T15:36:06.446Z","etag":null,"topics":["agent-config","ai-agents","anthropic","claude-code","codex","developer-tools","dotfiles","prompt-engineering","skills","subagents"],"latest_commit_sha":null,"homepage":null,"language":"Shell","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/casoon.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null,"notice":null,"maintainers":null,"copyright":null,"agents":null,"dco":null,"cla":null}},"created_at":"2026-04-21T08:21:27.000Z","updated_at":"2026-05-20T14:10:20.000Z","dependencies_parsed_at":null,"dependency_job_id":null,"html_url":"https://github.com/casoon/ai-agent-config","commit_stats":null,"previous_names":["casoon/ai-agent-config"],"tags_count":0,"template":true,"template_full_name":null,"purl":"pkg:github/casoon/ai-agent-config","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/casoon%2Fai-agent-config","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/casoon%2Fai-agent-config/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/casoon%2Fai-agent-config/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/casoon%2Fai-agent-config/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/casoon","download_url":"https://codeload.github.com/casoon/ai-agent-config/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/casoon%2Fai-agent-config/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":33416316,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-05-23T22:14:44.296Z","status":"ssl_error","status_checked_at":"2026-05-23T22:14:43.778Z","response_time":53,"last_error":"SSL_read: unexpected eof while reading","robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":false,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["agent-config","ai-agents","anthropic","claude-code","codex","developer-tools","dotfiles","prompt-engineering","skills","subagents"],"created_at":"2026-05-24T00:03:32.798Z","updated_at":"2026-05-24T00:03:34.180Z","avatar_url":"https://github.com/casoon.png","language":"Shell","funding_links":[],"categories":[],"sub_categories":[],"readme":"# ai-agent-config\n\nShareable baseline configuration for Claude Code and Codex.\n\nThe repo holds a single neutral tree. At install time, each tool-specific\nlink script symlinks the shared files into the tool's config directory\n(`~/.claude/` resp. `~/.codex/`) under the names that tool expects.\n\n\u003e **Status: example, being validated in practice.**\n\u003e This repo is a first cut at sharing a global AI-assistant configuration\n\u003e across tools (Claude Code, Codex, eventually Mistral Vibe). I am currently\n\u003e using it on my own machine to see whether the approach holds up — where\n\u003e the rough edges are, what needs to be simplified, and which parts are\n\u003e actually worth sharing. Expect breaking changes. Feedback and issues are\n\u003e welcome.\n\n## Intended use\n\nThis repo is a **template**, not a ready-to-link personal config. Running\n`install/link-all.sh` directly from a clone of this repository will\nreplace your existing `~/.claude/CLAUDE.md`, `~/.claude/skills/`,\n`~/.codex/AGENTS.md`, `~/.codex/config.toml`, and `~/.codex/skills/` with\nthe generic content here. Existing non-symlink targets are moved to\n`\u003cpath\u003e.bak`, so nothing is lost, but your real personal config stops\nbeing active until you restore it.\n\n**Recommended workflow:**\n\n1. Fork or clone this repo into a **private** copy.\n2. In the private copy, manually merge your existing files from\n   `~/.claude/` and `~/.codex/` into `GLOBAL.md`, `skills/`, and\n   `codex-config.toml`.\n3. Run `install/link-all.sh` from the **private** copy only.\n4. Pull updates from this template into the private copy via\n   `git merge` or cherry-pick as needed.\n\n## Layout\n\n```\n./\n├── GLOBAL.md              # global instructions (→ CLAUDE.md / AGENTS.md)\n├── agents/                # subagent sources (Markdown + YAML frontmatter)\n├── codex-agents/          # generated from agents/ — do not edit by hand\n├── skills/                # reusable skills (one folder with SKILL.md each)\n├── codex-config.toml      # Codex-only runtime profiles\n├── scripts/\n│   └── render-codex-agents.py\n├── .githooks/\n│   └── pre-commit         # regenerates codex-agents/ on commit\n└── install/\n    ├── link-claude.sh\n    ├── link-codex.sh\n    └── link-all.sh\n```\n\n## Install\n\n```sh\n./install/link-all.sh\n```\n\nThe scripts create symlinks under `~/.claude/` and `~/.codex/`:\n\n| Source                  | Claude target            | Codex target              |\n| ----------------------- | ------------------------ | ------------------------- |\n| `GLOBAL.md`             | `~/.claude/CLAUDE.md`    | `~/.codex/AGENTS.md`      |\n| `agents/`               | `~/.claude/agents`       | — (uses `codex-agents/`)  |\n| `codex-agents/`         | —                        | `~/.codex/agents`         |\n| `skills/`               | `~/.claude/skills`       | `~/.codex/skills`         |\n| `codex-config.toml`     | —                        | `~/.codex/config.toml`    |\n\nIf a target path exists and is not already a symlink, it is moved to\n`\u003cpath\u003e.bak` before the new symlink is created. Already-existing symlinks\nare replaced silently.\n\n## Supported platforms\n\nThe install scripts use plain portable Bash (`ln -sfn`, `mkdir -p`, `mv`)\nand do not depend on macOS-specific tooling.\n\n| Platform      | Status                                                      |\n| ------------- | ----------------------------------------------------------- |\n| **macOS**     | Tested.                                                     |\n| **Linux**     | Expected to work — not actively tested. Please open an issue if something breaks. |\n| **Windows**   | Not supported natively. Use **WSL2** (Ubuntu / Debian) — from inside WSL the Linux path applies. |\n\nRequirements on any platform: `bash`, `python3` (for the codex-agent\nrenderer), and `git`. `nosecrets` is optional but recommended — see\nbelow.\n\n## Single source of truth\n\n`agents/*.md` is the **only** place to edit agent prompts.\n`codex-agents/*.toml` is generated and should never be edited directly:\n\n```sh\npython3 scripts/render-codex-agents.py\n```\n\nThis is run automatically on commit via `.githooks/pre-commit`. Enable the\nhook once per clone:\n\n```sh\ngit config core.hooksPath .githooks\n```\n\n### Pre-commit hook\n\n`.githooks/pre-commit` does two things on every commit:\n\n1. Regenerates `codex-agents/*.toml` from `agents/*.md` and stages the\n   result, so the Codex-side prompts can never drift out of sync with\n   the Markdown sources.\n2. Runs [`nosecrets`](https://github.com/casoon/nosecrets) against the\n   staged files and aborts the commit on findings.\n\nIf `nosecrets` is not installed, the hook prints a visible error and\n**continues** — the commit is not blocked, but nothing was scanned.\nInstall one-off per machine:\n\n```sh\n# curl (macOS / Linux, installs a prebuilt binary)\ncurl -fsSL https://raw.githubusercontent.com/casoon/nosecrets/main/install.sh | sh\n\n# or via npm\nnpm install -g @casoon/nosecrets\n\n# or via cargo\ncargo install nosecrets-cli\n```\n\n## Memory scope\n\nThis repo manages the **global** layer of Claude Code's memory system — the\nper-user `CLAUDE.md` (and Codex's `AGENTS.md`), plus reusable skills and\nsubagent prompts. It deliberately does **not** cover:\n\n- **Project memory** — each project's own `CLAUDE.md` lives in that\n  project's repo, not here.\n- **Conversational memory** — Claude Code's per-session auto-memory under\n  `~/.claude/projects/…` is machine-local, often personal, and must never\n  be committed to a shared baseline.\n\n## Private additions\n\n`GLOBAL.md` ends with a marked \"private section\". Personal specifics —\npreferred package managers, daily languages, commit conventions, project\nquirks — belong there and should live in a **private fork** of this repo,\nnot in the shared baseline.\n\n## Change workflow\n\n- Edit `GLOBAL.md`, `agents/*.md`, or `skills/*/SKILL.md` — symlinks make\n  the change immediately live for Claude. For Codex, the pre-commit hook\n  regenerates `codex-agents/` before the change is committed.\n- Keep the global instruction file short. Stack-specific knowledge belongs\n  in skills; role prompts belong in agents.\n\n## License\n\n[MIT](LICENSE) — do whatever you like with it, attribution appreciated but\nnot required.\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fcasoon%2Fai-agent-config","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fcasoon%2Fai-agent-config","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fcasoon%2Fai-agent-config/lists"}