1
0
Fork 0
mirror of https://github.com/jimeh/agentic.git synced 2026-06-19 21:10:52 +00:00
Shared configuration and rules for AI coding agents (Claude Code, Codex, etc.)
Find a file
Jim Myhrberg 499a22e575
chore(claude): refresh desktop preferences
Capture the active Claude desktop preferences in repo-managed config so the
symlinked setup matches the current local environment.

This clears generated PR attribution, pins the configured model, records the
dark theme, and keeps notification channel ordering stable.
2026-06-13 15:53:57 +01:00
.claude chore(claude): add mise format and lint permissions 2026-03-26 23:02:44 +00:00
.claude-plugin fix(skills): normalize skill identifiers 2026-05-18 16:11:38 +01:00
.github/workflows feat: add oxfmt and markdownlint for Markdown formatting 2026-02-25 23:57:18 +00:00
.husky chore(git): enforce linting before commits 2026-05-13 17:55:57 +01:00
.vscode chore(vscode): use formatter-specific oxc setting 2026-05-08 09:52:41 +01:00
claude chore(claude): refresh desktop preferences 2026-06-13 15:53:57 +01:00
codex chore(codex): refresh desktop configuration 2026-06-13 15:53:57 +01:00
docs/references feat: add phased-work plugin for research-plan-implement workflow 2026-02-23 12:05:49 +00:00
plugins fix(skills): normalize skill identifiers 2026-05-18 16:11:38 +01:00
scripts fix(harness): reject malformed slug separators 2026-05-18 18:45:51 +01:00
skills feat(harness): harden tool and workflow guidance 2026-06-09 00:00:06 +01:00
.coderabbit.yaml chore(coderabbit): defer markdown formatting to local checks 2026-05-13 18:48:43 +01:00
.editorconfig feat: add oxfmt and markdownlint for Markdown formatting 2026-02-25 23:57:18 +00:00
.gitignore feat: add oxfmt and markdownlint for Markdown formatting 2026-02-25 23:57:18 +00:00
.markdownlint-cli2.jsonc chore: add package.json, bun lockfile, and vscode settings 2026-04-01 13:15:35 +01:00
.oxfmtrc.json chore: add package.json, bun lockfile, and vscode settings 2026-04-01 13:15:35 +01:00
AGENTS.md chore(codex): refresh desktop configuration 2026-06-13 15:53:57 +01:00
bun.lock chore(harness): add agent metadata checks 2026-05-18 16:31:52 +01:00
bunfig.toml chore(harness): add agent metadata checks 2026-05-18 16:31:52 +01:00
CLAUDE.md docs: add AGENTS.md with CLAUDE.md as thin reference 2026-02-15 14:33:36 +00:00
mise.toml chore(harness): add agent metadata checks 2026-05-18 16:31:52 +01:00
package.json chore(harness): add agent metadata checks 2026-05-18 16:31:52 +01:00
README.md feat: add fd plugin for Feature Design tracking 2026-03-04 00:07:15 +00:00
RULES.md feat(git-commands): forbid staging gitignored files by default 2026-04-16 22:40:20 +01:00
setup.sh feat(codex): install custom pets through setup 2026-05-27 11:12:19 +01:00

agentic

My personal AI coding agent configuration, with any quirks, oddities, opinionated rules, and hallucination-inducing prompt fragments I live with on a daily basis.

One repo, one set of rules, symlinked into every agent's config directory. Supports Claude Code, Codex, and any tool that reads AGENTS.md.

Warning

This is my personal config. It is not a starter kit, a framework, or a best-practices guide. If you use it as-is, things will probably work — but they'll work my way, which may not be your way. Browse for ideas, steal what's useful, but don't say I didn't warn you.

Quick Start

git clone https://github.com/jimeh/agentic.git ~/.config/agentic
cd ~/.config/agentic
./setup.sh            # create symlinks (skips existing)
./setup.sh --force    # replace existing (backs up to .bak)

This creates symlinks from the repo into ~/.claude/, ~/.agents/, and ~/.codex/, and registers plugin marketplaces and installs plugins via the Claude CLI. Run ./setup.sh --help for details.

What's Inside

  • RULES.md — Single source of truth for all agent behavior rules. Symlinked as the global rules file for each supported agent. Edit this file directly — never edit the symlink targets.
  • claude/ — Claude Code settings and statusline script.
  • codex/ — OpenAI Codex config.
  • skills/ — Custom skills (auto-discovered by setup.sh).
  • plugins/ — Claude Code plugins, published via a local marketplace.
  • docs/references/ — External articles and guides.

Skills are auto-discovered — drop a directory in the right place, re-run setup.sh, done. Commands live in plugins. Plugins are registered and installed via the Claude CLI (claude plugin marketplace add / claude plugin install).

Plugins

strip-git-cwd

A PreToolUse hook that strips redundant git -C <cwd> flags from Bash commands when the path matches the current working directory. Claude Code tends to add these unnecessarily, and the -C flag changes the command string enough that pre-approved git commands no longer match the allowlist — causing repeated permission prompts.

Handles all -C syntax variants (space, =, bare, quoted) and compound commands (&&, ;).

git-commands

Slash commands for common git workflows:

  • /commit — Stage changes, create a well-formed commit.
  • /commit-push-pr — Commit, push, and open a PR.
  • /rebase — Rebase onto upstream main/master.
  • /clean-gone-branches — Clean up branches deleted on remote.

Derived from the official commit-commands plugin, heavily modified.

agents-md

Slash commands for managing AGENTS.md files:

  • /claude-md-to-agents-md — Convert CLAUDE.md to AGENTS.md.
  • /generate-agents-md — Generate AGENTS.md from codebase analysis.
  • /refactor-agents-md — Refactor AGENTS.md for progressive disclosure.

phased-work

A disciplined research-plan-implement workflow. Instead of jumping straight to code, you move through distinct phases so every decision is reviewed before implementation begins.

  • /research — Deep-read a codebase area, write findings to research.md.
  • /plan — Create a detailed implementation plan in plan.md.
  • /refine — Address inline notes you've added to the plan.
  • /todo — Add a granular task breakdown to the plan.
  • /implement — Execute the plan mechanically, marking progress.
  • /review — Optional post-implementation sanity check.

Also includes agent-agnostic prompt snippets for use with any AI coding assistant.

fd

Initializes a lightweight Feature Design (FD) tracking system in any project. Scaffolds directory structure, templates, index, project-local slash commands, and CLAUDE.md conventions for the full FD lifecycle.

  • /fd-init — Set up the FD system in the current project.

Based on the Feature Design system by manuelschipper.

Standalone Installation

You can install individual plugins directly without cloning the repo. First add the marketplace, then install whichever plugins you want:

# CLI
claude plugin marketplace add jimeh/agentic

# Or from within Claude Code
/plugin marketplace add jimeh/agentic

Then install plugins:

# CLI
claude plugin install git-commands@jimeh-agentic

# Or from within Claude Code
/plugin install git-commands@jimeh-agentic

Installation via setup.sh

setup.sh ensures both the official claude-plugins-official marketplace and this repo's local marketplace are registered, then installs plugins listed in the CLAUDE_PLUGINS array at the top of the script. To add or remove auto-installed plugins, edit that array.

Requires the claude CLI and jq. Skipped gracefully if either is missing.

Requirements

  • Bash 3.2+ (macOS default works)
  • For symlink resolution, setup.sh tries realpath first, then platform-specific fallbacks:
    • macOS: python3, python, perl, or readlink
    • Linux: readlink -f (part of coreutils)

License

This is a personal configuration repository. Feel free to use it as inspiration for your own setup, but there are no guarantees it won't teach your agents some questionable habits.