Metadata-Version: 2.4
Name: onecontext-ai
Version: 0.9.3
Summary: OneContext CLI for capturing, searching, and sharing AI coding session context
Author: Sharemind
License-Expression: MIT
Project-URL: Homepage, https://github.com/human-re/aline
Project-URL: Repository, https://github.com/human-re/aline
Project-URL: Documentation, https://github.com/human-re/aline#readme
Project-URL: Bug Tracker, https://github.com/human-re/aline/issues
Keywords: ai,agent,chat,history,mcp,claude,session-tracking,context-preservation
Classifier: Development Status :: 3 - Alpha
Classifier: Intended Audience :: Developers
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.11
Classifier: Programming Language :: Python :: 3.12
Classifier: Programming Language :: Python :: 3.13
Classifier: Operating System :: OS Independent
Requires-Python: >=3.11
Description-Content-Type: text/markdown
Requires-Dist: typer>=0.9.0
Requires-Dist: pyyaml>=6.0
Requires-Dist: rich>=13.0.0
Requires-Dist: detect-secrets>=1.4.0
Requires-Dist: cryptography>=41.0.0
Requires-Dist: httpx>=0.24.0
Requires-Dist: textual>=0.50.0
Requires-Dist: pyzmq>=25.0.0
Provides-Extra: dev
Requires-Dist: build>=1.2.2; extra == "dev"
Requires-Dist: pytest>=7.0.0; extra == "dev"
Requires-Dist: pytest-cov>=4.0.0; extra == "dev"
Requires-Dist: black>=23.0.0; extra == "dev"
Requires-Dist: mypy>=1.0.0; extra == "dev"
Requires-Dist: twine>=6.1.0; extra == "dev"
Requires-Dist: bump-my-version>=0.26.0; extra == "dev"

# 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:

```bash
pip install onecontext-ai
```

npm wrapper:

```bash
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:

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

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

### Examples

```bash
# 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:

```bash
# Recommended
onecontext update
```

If upgrade routing is broken, repair once and retry:

```bash
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:

```bash
onecontext uninstall
```

If installed via npm wrapper, also remove wrapper package:

```bash
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.
