oh-my-pi: Detailed Introduction

[ikaijua]

oh-my-pi: Detailed Introduction

A Pi-derived terminal agent integrating language servers, debuggers, and code execution.

• Audience: Users who want development, debugging, and review in a terminal and can configure the toolchain.
• Cost: MIT software; model, search, and external-service usage are billed separately.

Table of Contents

Getting started

1. What it is and who it is for
2. Access and setup: your first session

Usage and configuration

3. A concrete task and how to check it
4. Costs: software, models, and execution
5. Configuration and extensions

Limits and references

6. Permissions, data, and limitations
7. Frequently asked questions
8. Official references

Use the contents to jump to each section. If an in-page link does not respond, open it in a new tab.

[ikaijua]

What it is and who it is for

In one sentence: A Pi-derived terminal agent integrating language servers, debuggers, and code execution.

Who it suits: Users who want development, debugging, and review in a terminal and can configure the toolchain.

What you can do:

• Edit files with language-server diagnostics.
• Investigate runtime issues through debugger adapters.
• Use subagents and review commands for larger tasks.

Where to start: Install from omp.sh or the repository. Its command is omp, not Pi’s pi.

Cost: MIT software; model, search, and external-service usage are billed separately.

[ikaijua]

Access and setup: your first session

Install from omp.sh or the repository. Its command is omp, not Pi’s pi.

brew install can1357/tap/omp
omp

Bun, Nix, and Windows options are documented too. Connect a model before the first task.

[ikaijua]

A concrete task and how to check it

Start with a reproducible failure rather than a request to optimize the entire project.

Example:

Reproduce this failing test, fix the smallest cause, rerun that test, and list actual changes. Avoid unrelated refactoring.

Confirm the relevant language server or debugger adapter is installed when needed. Check both the test result and patch scope.

[ikaijua]

Costs: software, models, and execution

The client is MIT-licensed. Your model provider sets inference charges. Subagents, advisor models, search, and other tools may add requests.

Complete a small task with one model before enabling parallel workers and advisors. Compare total task cost, not token prices alone.

[ikaijua]

Configuration and extensions

OMP provides language services, debugging, Python/Bun execution, subagents, advisors, and review. /review can inspect branches, commits, or uncommitted changes.

Language-specific capabilities depend on the corresponding toolchain. Configure and verify one language first. LSP configuration

[ikaijua]

Permissions, data, and limitations

This terminal agent runs real commands and edits files. Execution and debugging depend on the local environment.

Project examples and author-reported results do not establish your own success rate. Missing adapters, failed language-server connections, or unsuitable tool-calling models can interrupt work.

[ikaijua]

Frequently asked questions

Is this the same package as Pi? No; it has its own command, package, and defaults.

Is a particular model required? Choose a supported provider in the configuration.

Does a favorable review justify merging? Check findings, tests, and project requirements independently.

[ikaijua]

Official references

• Repository and setup
• Website
• LSP configuration
• MIT license