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, orpip - 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:
- Repair and update:
onecontext doctor --fix-upgrade && onecontext update - Rebuild wrapper links if needed:
npm rebuild onecontext-ai - Check that
onecontextis 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.
Metadata
Release files for onecontext-ai 0.9.3
For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.
Built distribution (wheel)
| File | Interpreter | ABI | Platform | Actions Reset |
|---|---|---|---|---|
| onecontext_ai-0.9.3-py3-none-any.whl | Python 3 | none | any | Details for onecontext_ai-0.9.3-py3-none-any.whl |
Release files / onecontext_ai-0.9.3-py3-none-any.whl
| Download URL | onecontext_ai-0.9.3-py3-none-any.whl |
|---|---|
| Size | 621.0 kB |
| Tags | Python 3 |
|
SHA-256 checksum How to use checksums |
c932cdb729414536ee062c78b4a2f98caf2b951bcca64f9f46b4197d9002ed8b
|
|
BLAKE2b-256 checksum How to use checksums |
b53460372492a5213a6c49912b8729aa1926e7980e6df29642e96f4bcaceba64
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
twine/6.2.0 CPython/3.11.5
|
Security for onecontext-ai 0.9.3
Provenance
Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.
No provenance found
None of the files in this release were uploaded with provenance metadata.
A note on package security
PyPI is a repository for distributing packages, not a service for auditing them. While third-party security researchers and our staff do their best to detect and remove malicious packages, PyPI cannot guarantee the quality, security or suitability of any given package.
To learn more about protecting yourself from malicious actors, visit our package security documentation.