oh-my-setting

Sync agent rules, skills, and project templates across machines.

한국어

Local-First Agents

oh-my-setting keeps agent work local and shell-visible by default:

• No MCP servers, app connectors, or plugin connector tools.
• Use local files, shell commands, git, and gh CLI.
• Multi-agent review stays local: Codex, Claude Code, and Antigravity CLI when available.
• If local multi-agent tools are missing, run a single-agent review and report that limitation.

Quickstart

curl -fsSL https://raw.githubusercontent.com/eightmm/oh-my-setting/main/install.sh | bash
cd /path/to/project
~/.oh-my-setting/scripts/apply-project-template.sh auto .

Then paste the matching prompt from Agent Prompts into the agent.

Install

curl -fsSL https://raw.githubusercontent.com/eightmm/oh-my-setting/main/install.sh | bash

Existing installs update to the latest checkout before setup continues. After first-time nvm setup, open a new shell if newly installed CLIs are not found. Installer-managed Node uses Node 20 or newer.

Options:

OH_MY_SETTING_STAR_PROMPT=0       # skip GitHub star prompt
OH_MY_SETTING_GENERATE_MACHINE=0  # skip machine snapshot
OH_MY_SETTING_GENERATE_SLURM=0    # skip Slurm snapshot
OH_MY_SETTING_INSTALL_TOOLS=0     # skip Node/uv/agent CLI install
OH_MY_SETTING_REQUIRE_TOOLS=0     # do not fail doctor on missing CLIs
OH_MY_SETTING_DIR=/path/to/dir    # install location

When running a local installer, --no-star is equivalent to OH_MY_SETTING_STAR_PROMPT=0.

Installed paths:

~/.codex/AGENTS.md
~/.claude/CLAUDE.md
~/.pi/agent/AGENTS.md
~/.oh-my-setting/local/machine.md

Check current install status:

~/.oh-my-setting/scripts/status.sh

Update the local checkout, refresh symlinks, and re-run doctor:

~/.oh-my-setting/scripts/update.sh           # git pull + tools + link + doctor
~/.oh-my-setting/scripts/update.sh --no-tools --no-doctor

Run a three-model review of the tracked staged + unstaged repo diff:

~/.oh-my-setting/scripts/multi-agent-review.sh \
  --prompt "Review the current diff for bugs, regressions, missing tests, and unsafe operations."

Providers run in parallel. Per-provider artifacts plus a _synthesis-*.md summary are written to .omc/artifacts/review/. The wrapper sends sanitized diff/status context to the local Codex, Claude Code, and Antigravity CLIs; secret paths and secret-like added lines are excluded before external review.

Ask a conceptual question to all three models:

~/.oh-my-setting/scripts/multi-agent-ask.sh \
  --prompt "Compare RAG and fine-tuning tradeoffs for this project."

Per-provider ask artifacts plus a _synthesis-*.md summary are written to .omc/artifacts/ask/. No repo context is attached unless --repo-context or --diff is passed.

Project Setup

Auto-detect:

~/.oh-my-setting/scripts/apply-project-template.sh auto .

Choose explicitly:

~/.oh-my-setting/scripts/apply-project-template.sh general .
~/.oh-my-setting/scripts/apply-project-template.sh ml .
~/.oh-my-setting/scripts/apply-project-template.sh slurm .

What it does:

• Adds/updates managed blocks in AGENTS.md and CLAUDE.md.
• Creates PROJECT.md if missing.
• Does not overwrite user content outside managed blocks.
• For ML projects on Slurm machines, adds ml plus separate slurm rules.

Remove project rules:

~/.oh-my-setting/scripts/remove-project-template.sh all .

Detect only:

~/.oh-my-setting/scripts/detect-project-style.sh .

Agent Prompts

New project:

Use the local oh-my-setting project workflow. Do not code yet.

Start a new project by creating only the safe skeleton, then interview me to
fill PROJECT.md before implementation.

Success criteria:
- clarify goal, users, non-goals, interface, data, paths, commands, risks, and verification
- write or update PROJECT.md with confirmed answers
- wait for confirmation before source code, dependency, API, data, or compute changes
- report changed files and checks

Existing project:

Read local project files first. Start by inspecting AGENTS.md/CLAUDE.md,
PROJECT.md if present, README, pyproject/configs, and git status. Do not edit yet.

Goal: understand this existing project and propose the smallest safe next step
to onboard or continue it with oh-my-setting rules.

Report:
- project type and current structure
- setup/test/run commands you can infer
- missing or draft PROJECT.md fields
- risks before editing
- recommended next prompt

ML Projects

mkdir my-project
cd my-project
~/.oh-my-setting/scripts/apply-project-template.sh ml .

Expected agent flow:

1. create only the safe skeleton
2. interview
3. fill/confirm PROJECT.md
4. code after confirmation

ML projects use:

• uv sync
• local .venv
• uv run ...
• machine snapshot only when compute, GPU/CUDA, Slurm, memory, or environment details affect the task

Local Snapshots

Machine snapshot:

~/.oh-my-setting/scripts/write-machine-snapshot.sh

Writes:

~/.oh-my-setting/local/machine.md

Also records local agent CLI paths for Codex, Claude Code, Antigravity, Pi, and gh when found.

Slurm snapshot:

~/.oh-my-setting/scripts/generate-slurm-skill.sh

Writes:

~/.oh-my-setting/custom-skills/slurm-hpc/references/cluster.generated.md

Include raw Slurm outputs:

OH_MY_SETTING_SLURM_WRITE_RAW=1 ~/.oh-my-setting/scripts/generate-slurm-skill.sh

Unlink

Remove oh-my-setting symlinks and restore the latest matching *.backup.TIMESTAMP files when present:

~/.oh-my-setting/scripts/unlink.sh

It only removes symlinks that point to the current oh-my-setting checkout. Existing regular files and unrelated symlinks are skipped.

Preview unlink:

OH_MY_SETTING_DRY_RUN=1 ~/.oh-my-setting/scripts/unlink.sh

Uninstall

Remove symlinks (same as unlink.sh) and optionally delete the checkout:

~/.oh-my-setting/scripts/uninstall.sh           # unlink only
~/.oh-my-setting/scripts/uninstall.sh --purge   # also delete the checkout (prompts)
~/.oh-my-setting/scripts/uninstall.sh --purge --yes --dry-run

--purge refuses to delete $HOME or /. nvm, uv, and CLI binaries installed by install-tools.sh are not removed.

Safety

Do not commit tokens, API keys, private data, generated cluster details, or local machine details.

Star

If this helped:

gh api --method PUT /user/starred/eightmm/oh-my-setting