Research Notes

OMP Windows PyCharm CLI

2 min read

Concise Windows setup for OMP, a terminal coding agent with IDE-style wiring: LSP, DAP, subagents, plan mode, hindsight memory, hashline edits, and rules.

1. Install prerequisites

Open PowerShell:

winget install Git.Git
winget install OpenJS.NodeJS.LTS

Close and reopen PowerShell, then check:

git --version
node -v
npm -v

Git for Windows matters because OMP needs a Bash shell on Windows. The installer will look for Git Bash at:

C:\Program Files\Git\bin\bash.exe

2. Install OMP

Use this exact PowerShell install path:

irm https://omp.sh/install.ps1 | iex

Then restart PowerShell and check:

omp --version

Default behavior:

  • If Bun is already installed, OMP installs through bun install -g @oh-my-pi/pi-coding-agent.
  • If Bun is not installed, OMP downloads the Windows binary to %LOCALAPPDATA%\omp.
  • The installer adds OMP to your user PATH if needed.
  • It writes Bash shell config to %USERPROFILE%\.omp\agent\settings.json.

3. Run OMP in a project

cd C:\dev\your-project
git status
omp

Good first prompt:

Use plan mode. Inspect this repository and explain the architecture.
Do not edit files yet.
Tell me the smallest safe first change for <task>.

For an implementation:

Goal: make the smallest safe change that implements <task>.
Before editing, inspect the relevant files and explain the plan.
Do not touch unrelated files.
After editing, run the smallest relevant test or check.
Summarize changed files, commands run, and remaining risks.

4. Use with PyCharm on Windows

In PyCharm:

  1. Open the project folder.
  2. Open Terminal inside PyCharm.
  3. Make sure it starts in the project root.
  4. Run:
git status
omp

Keep PyCharm open while OMP works:

  • Use PyCharm for file review, search, debugger, test UI, and Git diff.
  • Use OMP in the PyCharm terminal for agentic repo edits.
  • Before accepting changes, inspect PyCharm’s Git diff.
  • Run the smallest relevant test from PyCharm or the same terminal.

If OMP says Bash is missing, install Git for Windows and rerun:

irm https://omp.sh/install.ps1 | iex

Manual shell config path:

%USERPROFILE%\.omp\agent\settings.json

Example:

{
  "shellPath": "C:\\Program Files\\Git\\bin\\bash.exe"
}

Sources