OneContext CLI (onecontext-ai on PyPI)

OneContext CLI helps you capture, search, and share AI coding session context across tools.

Links

• GitHub repository: https://github.com/LastPieceAI/OneContext
• Issues: https://github.com/LastPieceAI/OneContext/issues

Installation

Python:

pip install onecontext-ai

npm wrapper:

npm install -g onecontext-ai

After install, run onecontext to start.

Prerequisites

• Python >=3.11 with one of: uv, pipx, pip3, or pip
• Node.js >= 16

What Gets Installed and Configured

On first launch (onecontext), OneContext sets up local integrations so the CLI works across agents:

• Installs OneContext skills into Claude/Codex skill locations so you can use built-in workflows.
• Installs Claude/Codex hooks used by cross-agent session workflows (including import-history session management).

OneContext runs cloud LLM features using our own securely managed service tokens. You NEVER need to provide personal API keys — and your own provider tokens are NEVER used for these workflows.

Usage

After installation, the following commands are available:

onecontext <command> [args...]
aline <command> [args...]
oc <command> [args...]

All three commands are equivalent and proxy to the underlying Python CLI.

Examples

# Check version
onecontext version

# Show help
onecontext --help

# Short alias
aline version
oc version

Updating the Python Package

The npm wrapper installs the latest onecontext-ai on npm install.

For normal users, use the unified upgrade command:

# Recommended
onecontext update

If upgrade routing is broken, repair once and retry:

onecontext doctor --fix-upgrade
onecontext update

Use npm rebuild onecontext-ai only when the npm wrapper links/cached paths are stale.

Uninstall

Recommended app-level uninstall:

onecontext uninstall

If installed via npm wrapper, also remove wrapper package:

npm uninstall -g onecontext-ai

Troubleshooting

If the commands aren't found after installation:

1. Repair and update: onecontext doctor --fix-upgrade && onecontext update
2. Rebuild wrapper links if needed: npm rebuild onecontext-ai
3. Check that onecontext is on your PATH: which onecontext

Naming Note

• PyPI package name is onecontext-ai.
• npm package uses the same branding: onecontext-ai.
• All commands proxy to the same CLI app (onecontext, aline, oc).

The project started as Aline and later moved to OneContext branding.