onecontext-ai

npm wrapper for OneContext AI (the onecontext-ai Python package).

Links

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

Installation

npm install -g onecontext-ai

After install, run onecontext to start.

This will automatically install the latest onecontext-ai Python package using the best available Python package manager (uv > pipx > pip3 > pip).

Compatibility policy for this wrapper release:

• Supported onecontext-ai range is configured in package.json at onecontextConfig.alineVersionRange.
• If an incompatible onecontext-ai version is detected during npm install/rebuild, the wrapper attempts a compatible reinstall and fails with a clear error if it cannot enforce compatibility.

Prerequisites

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

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 uninstall from app level:

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.

License

MIT