oppie

A project-management operations CLI with a plan/apply workflow. Propose changes from natural-language prompts, review them as structured operations, then apply.

Install

oppie is distributed on PyPI. Core install:

pip install oppie

Optional features ship as extras:

An LLM backend is required for normal use. Most users want:

pip install 'oppie[openai,linear]'

For Anthropic Claude instead of local models:

pip install 'oppie[anthropic,linear]'

Quickstart

# 1. Initialize an instance in the current directory
oppie init

# 2. (optional) View or edit config
oppie config show

# 3. Ask a question or request a plan
oppie "what's the status of the migration work?"

oppie init walks through picking an instance type (local or Linear-backed), configuring an LLM backend, and optionally seeding context docs.

Usage example

End-to-end: ask for a plan, review it, then apply it.

$ oppie "update the priority of the auth-rewrite ticket to high"
● Classifying intent…
● Generating plan…
Plan plan-01HX… (1 operation)
  - update ticket TKT-42: priority = high

$ oppie apply plan-01HX…
✓ Applied 1 operation

Plans are content-addressed and stored under the instance home; re-running with the same prompt produces the same plan id when nothing has changed.

CLI flag reference

Root flags (apply to every subcommand):

Conversational CLI (oppie "<prompt>"):

Selected subcommand flags:

Run oppie --help or oppie <command> --help for the full list.

Exit codes

General contract for all commands:

oppie sync returns a more granular code so CI scripts can distinguish retryable failures:

Development

# Install dev deps (all extras)
uv sync --all-extras

# Pre-commit
uv run pre-commit run --all-files

# Tests
uv run pytest

# Lint and format
uv run ruff check .
uv run ruff format .