Quickstart

Install ompCopy Anchor Link

curl -fsSL https://omp.sh/install | sh

Confirm that the executable is available:

omp --version

Open your projectCopy Anchor Link

Change into the project you want omp to work on. The directory where you launch omp becomes the project root for the session.

cd ~/code/my-project

Replace ~/code/my-project with your project’s path.

If you use an API key, export it in this terminal before launch. For example:

export ANTHROPIC_API_KEY=sk-ant-...

If you use a provider subscription with browser sign-in, skip that command; the first-run setup will sign you in.

Now launch the interactive app:

omp

Sign in and choose a modelCopy Anchor Link

The first launch opens a setup wizard.

1. On Set up your providers, keep the Sign in tab selected, choose your provider, and press Enter. Complete the browser login, then return to the terminal. You can sign in to more than one provider.
2. If you exported an API key instead, it is already available to omp; press Esc to leave the provider step.
3. Press Esc when you are done connecting providers.
4. On Choose your default model, type to search, highlight a model from the provider you configured, and press Enter. omp saves this choice for new sessions.
5. Finish the remaining terminal appearance prompts. They preview each choice before you save it.

Later launches go directly to the prompt. OAuth users can reopen sign-in with /login; use /model to change the current session’s model.

Give omp a coding taskCopy Anchor Link

At the prompt, type a concrete outcome in ordinary language. This example works as a first tour of an unfamiliar project:

Inspect this project for one small bug or inconsistency that can be verified locally. Explain what you found, make the smallest safe fix, and run the most relevant check.

Press Enter. omp will inspect the project, show its actions as tool cards, edit files when needed, and stream its response. Press Ctrl+O to expand or collapse full tool output.

Review and continueCopy Anchor Link

Read the final summary and the reported check result. Ask for a focused review without leaving the session:

Show me the diff and explain each changed file. Do not make more changes.

Then continue with a follow-up, just as you would with a teammate:

Looks good. Run the relevant check once more and summarize any remaining risk.

If the agent is heading in the wrong direction during a turn, press Esc to interrupt it, then clarify the request.

Exit and resumeCopy Anchor Link

Press Ctrl+D or enter /exit to leave. omp saves the session automatically.

To continue the most recent session for this project, return to the same project directory and run:

omp --continue

The conversation and selected model reopen in the same project so you can send the next message. Run omp --resume instead when you want to choose from recent sessions.