python-outline

Python outliner CLI + MCP server for Codex and Claude.

Primary distribution: GitHub Release binaries (auto-built on version tags).

Install (Binary Release, Recommended)

Create a tag like v0.1.0 and push it; workflow will build binaries and publish a Release.

git tag v0.1.0
git push origin v0.1.0

Then install from latest release:

gh release download --repo cheeseonamonkey/python-outline-mcp --latest
chmod +x python-outline
./python-outline --list-metrics
./python-outline mcp

Install (Source, One Command)

git clone https://github.com/cheeseonamonkey/python-outline-mcp.git
cd python-outline-mcp
bash install.sh

That installs deps and configures MCP for both Codex + Claude.

Target-specific:

bash install.sh codex
bash install.sh claude
bash install.sh both

No clone needed (direct bootstrap):

bash <(curl -fsSL https://raw.githubusercontent.com/cheeseonamonkey/python-outline-mcp/main/install.sh) codex
bash <(curl -fsSL https://raw.githubusercontent.com/cheeseonamonkey/python-outline-mcp/main/install.sh) claude
bash <(curl -fsSL https://raw.githubusercontent.com/cheeseonamonkey/python-outline-mcp/main/install.sh) both

Install (With Transformer Outliner)

bash install.sh --target both --ai --precache-ai
# shorthand:
bash install.sh full

Use

python-outline --list-metrics
python-outline . --agent
python-outline /path/to/repo --json
python-outline /path/to/repo --threads 8
python-outline /path/to/repo --ai

Notes:

• --threads is off by default (1)
• --ai forces single-thread mode for stability

MCP Tools

Server id: python-outline

• outline: main outlining tool (metrics + optional mypy/pylint/vulture + optional AI summaries)
• explore: imports, calls, entry points

Binary Build (Optional)

python3 -m pip install pyinstaller
python3 build_python_outline_binary.py

Output:

• dist/python-outline (Linux/macOS)
• dist/python-outline.exe (Windows)

Run MCP mode from binary:

dist/python-outline mcp

Repo

Public repo: https://github.com/cheeseonamonkey/python-outline-mcp