oioxo-mcp 0.5.6 → 0.5.8
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/README.md +125 -120
- package/bundle/cli.js +87 -83
- package/package.json +62 -62
package/README.md
CHANGED
|
@@ -1,120 +1,125 @@
|
|
|
1
|
-
# OIOXO — cut your AI bill ~90%, and code privately from the terminal
|
|
2
|
-
|
|
3
|
-
**Your AI tools read far more of your code than they need — and you pay for every word.**
|
|
4
|
-
|
|
5
|
-
OIOXO fixes that from one command-line tool. It does two things:
|
|
6
|
-
1. **Makes Copilot, Cursor & Claude ~90% cheaper.** It sits between your project and your AI tools and hands them only the small, relevant slice — instead of letting them read whole files. Same answers, a fraction of the cost.
|
|
7
|
-
2. **Codes for you, privately.** `oioxo code "<task>"` plans, edits, and checks the work right in your repo — using your own key **or a local model** — so nothing leaves your machine. See [Code in your terminal](#code-in-your-terminal--oioxo-code).
|
|
8
|
-
|
|
9
|
-
|
|
10
|
-
|
|
11
|
-
## Quick start
|
|
12
|
-
|
|
13
|
-
```bash
|
|
14
|
-
npm install -g oioxo-mcp
|
|
15
|
-
|
|
16
|
-
oioxo login # connect your OIOXO account (opens the browser)
|
|
17
|
-
oioxo init # wire OIOXO into the agents in this project
|
|
18
|
-
```
|
|
19
|
-
|
|
20
|
-
Restart your agent. From the next prompt on, it calls OIOXO before reading files.
|
|
21
|
-
|
|
22
|
-
Prefer zero terminal? Install the [OIOXO VS Code extension](https://marketplace.visualstudio.com/items?itemName=oioxo.oioxo-vscode) — it wires every workspace automatically and shows your live savings in the status bar.
|
|
23
|
-
|
|
24
|
-
## Code in your terminal — `oioxo code`
|
|
25
|
-
|
|
26
|
-
OIOXO isn't only a context engine for *other* agents — it's a coding agent in its own right. `oioxo code` plans, edits, and **verifies on your machine** (runs your tests / typecheck), then shows the diff and asks before writing any file.
|
|
27
|
-
|
|
28
|
-
|
|
29
|
-
|
|
30
|
-
|
|
31
|
-
|
|
32
|
-
|
|
33
|
-
|
|
34
|
-
|
|
35
|
-
|
|
36
|
-
|
|
37
|
-
|
|
38
|
-
|
|
39
|
-
|
|
40
|
-
|
|
41
|
-
|
|
42
|
-
|
|
43
|
-
|
|
44
|
-
|
|
45
|
-
|
|
46
|
-
|
|
47
|
-
|
|
48
|
-
|
|
49
|
-
|
|
50
|
-
|
|
51
|
-
|
|
52
|
-
|
|
53
|
-
|
|
54
|
-
|
|
55
|
-
|
|
56
|
-
|
|
57
|
-
|
|
58
|
-
|
|
59
|
-
|
|
60
|
-
|
|
61
|
-
|
|
62
|
-
|
|
63
|
-
|
|
64
|
-
|
|
65
|
-
|
|
66
|
-
|
|
67
|
-
|
|
68
|
-
|
|
69
|
-
|
|
70
|
-
|
|
71
|
-
|
|
|
72
|
-
|
|
73
|
-
|
|
74
|
-
|
|
75
|
-
|
|
76
|
-
|
|
77
|
-
|
|
78
|
-
|
|
79
|
-
|
|
80
|
-
|
|
81
|
-
#
|
|
82
|
-
oioxo
|
|
83
|
-
|
|
84
|
-
|
|
85
|
-
|
|
86
|
-
#
|
|
87
|
-
oioxo
|
|
88
|
-
|
|
89
|
-
oioxo
|
|
90
|
-
|
|
91
|
-
|
|
92
|
-
oioxo
|
|
93
|
-
|
|
94
|
-
|
|
95
|
-
|
|
96
|
-
oioxo
|
|
97
|
-
|
|
98
|
-
|
|
99
|
-
|
|
100
|
-
oioxo
|
|
101
|
-
oioxo
|
|
102
|
-
|
|
103
|
-
#
|
|
104
|
-
oioxo
|
|
105
|
-
oioxo
|
|
106
|
-
oioxo
|
|
107
|
-
|
|
108
|
-
|
|
109
|
-
|
|
110
|
-
|
|
111
|
-
|
|
112
|
-
|
|
113
|
-
|
|
114
|
-
|
|
115
|
-
|
|
116
|
-
|
|
117
|
-
|
|
118
|
-
|
|
119
|
-
|
|
120
|
-
|
|
1
|
+
# OIOXO — cut your AI bill up to ~90%, and code privately from the terminal
|
|
2
|
+
|
|
3
|
+
**Your AI tools read far more of your code than they need — and you pay for every word.**
|
|
4
|
+
|
|
5
|
+
OIOXO fixes that from one command-line tool. It does two things:
|
|
6
|
+
1. **Makes Copilot, Cursor & Claude up to ~90% cheaper.** It sits between your project and your AI tools and hands them only the small, relevant slice — instead of letting them read whole files. Same answers, a fraction of the cost.
|
|
7
|
+
2. **Codes for you, privately.** `oioxo code "<task>"` plans, edits, and checks the work right in your repo — using your own key **or a local model** — so nothing leaves your machine. See [Code in your terminal](#code-in-your-terminal--oioxo-code).
|
|
8
|
+
|
|
9
|
+
**Up to ~90% fewer words per question** (measured on a real codebase). A question that would cost ~50,000 words can come back as ~5,000 — same answer, a fraction of the cost.
|
|
10
|
+
|
|
11
|
+
## Quick start
|
|
12
|
+
|
|
13
|
+
```bash
|
|
14
|
+
npm install -g oioxo-mcp
|
|
15
|
+
|
|
16
|
+
oioxo login # connect your OIOXO account (opens the browser)
|
|
17
|
+
oioxo init # wire OIOXO into the agents in this project
|
|
18
|
+
```
|
|
19
|
+
|
|
20
|
+
Restart your agent. From the next prompt on, it calls OIOXO before reading files.
|
|
21
|
+
|
|
22
|
+
Prefer zero terminal? Install the [OIOXO VS Code extension](https://marketplace.visualstudio.com/items?itemName=oioxo.oioxo-vscode) — it wires every workspace automatically and shows your live savings in the status bar.
|
|
23
|
+
|
|
24
|
+
## Code in your terminal — `oioxo code`
|
|
25
|
+
|
|
26
|
+
OIOXO isn't only a context engine for *other* agents — it's a coding agent in its own right. `oioxo code` plans, edits, and **verifies on your machine** (runs your tests / typecheck), then shows the diff and asks before writing any file.
|
|
27
|
+
|
|
28
|
+
<p align="center"><img src="https://aradsoftca.github.io/OIOXO/assets/terminal.gif" alt="oioxo code — reads only the slice it needs, plans, writes, runs your tests, then asks before writing" width="640"></p>
|
|
29
|
+
<p align="center"><sub><em>A real <code>oioxo code</code> run — reads ~5,000 words not 50,000, writes, runs your tests, and asks before it touches a file.</em></sub></p>
|
|
30
|
+
|
|
31
|
+
```bash
|
|
32
|
+
# with your own key (BYOK) — the capsule means even a frontier model reads ~10× fewer tokens
|
|
33
|
+
OPENAI_API_KEY=… oioxo code "add a --json flag to the status command"
|
|
34
|
+
ANTHROPIC_API_KEY=… oioxo code "fix the failing test" --verify "npm test"
|
|
35
|
+
|
|
36
|
+
# local Ollama — private, zero API tokens, nothing leaves your machine
|
|
37
|
+
OIOXO_PROVIDER=ollama OIOXO_MODEL=qwen2.5-coder oioxo code "add input validation to the signup form"
|
|
38
|
+
```
|
|
39
|
+
|
|
40
|
+
- **Verified, not vibes** — every change runs through your tests/typecheck on a shadow copy; a red result is fed back and repaired. Your real files are touched only after you approve the diff.
|
|
41
|
+
- **Bring any model** — OpenAI, Anthropic, Groq, Mistral, Together, local Ollama, or any OpenAI-compatible base (`OIOXO_PROVIDER` / `OIOXO_BASE_URL` / `OIOXO_MODEL` / `OIOXO_API_KEY`).
|
|
42
|
+
- **Or fully local, no key** — point it at [Ollama](https://ollama.com) (`OIOXO_PROVIDER=ollama OIOXO_MODEL=qwen2.5-coder`) and nothing leaves your machine. Or run the built-in on-device coder with **`oioxo code --local`** (open model via llama.cpp; one-time `npm i -g node-llama-cpp`) — no key, nothing uploaded.
|
|
43
|
+
|
|
44
|
+
Flags: `--verify "<cmd>"` (override the test command) · `--yes` (apply without the prompt) · `--max-iters N` · `--local` (built-in on-device coder, no key — one-time `npm i -g node-llama-cpp`).
|
|
45
|
+
|
|
46
|
+
## Let your devices build together
|
|
47
|
+
|
|
48
|
+
<p align="center"><img src="https://aradsoftca.github.io/OIOXO/assets/mesh.gif" alt="Compute Mesh — your phone borrows your laptop's power over Wi-Fi" width="620"></p>
|
|
49
|
+
|
|
50
|
+
Put two of your own devices on the **same Wi-Fi** and they work as one — this machine can lend
|
|
51
|
+
its power to another device's build (so your phone or a thin laptop builds on *this* machine's
|
|
52
|
+
GPU), or borrow power the other way. Start it with `oioxo invite` (or `oioxo join`); pairing is
|
|
53
|
+
just a short code (a QR or a string), with nothing going through our servers. Lend power and you
|
|
54
|
+
earn **free coding time** for it. *(Feature name: Compute Mesh.)*
|
|
55
|
+
|
|
56
|
+
## Why developers use it
|
|
57
|
+
|
|
58
|
+
- 💸 **Your AI costs drop by up to ~90%** — Copilot premium requests, Claude limits, and API keys all last several times longer.
|
|
59
|
+
- ⚡ **Better answers, too** — focused context beats 50k words of noise. Your AI gets the exact code in play, plus the parts it actually depends on.
|
|
60
|
+
- 🔒 **100% on your device** — your code is read and searched locally, never uploaded. Only the *amount* you saved is counted.
|
|
61
|
+
- 🪄 **One command** — `init` finds Claude Code, VS Code/Copilot, Cursor, Windsurf, Gemini CLI and Codex, and sets them up without touching your other tools.
|
|
62
|
+
|
|
63
|
+
## How it works (for you)
|
|
64
|
+
|
|
65
|
+
1. **Point it at your project** — `oioxo init` wires your agents in one command.
|
|
66
|
+
2. **Ask your agent normally** — it calls OIOXO first, gets just the relevant slice, and answers.
|
|
67
|
+
3. **Watch the savings add up** — `oioxo-mcp status` shows tokens saved; nothing about your code leaves your machine.
|
|
68
|
+
|
|
69
|
+
## Tools your agent gets
|
|
70
|
+
|
|
71
|
+
| Tool | What it does |
|
|
72
|
+
|---|---|
|
|
73
|
+
| `get_context` | The minimal relevant slice of the codebase for any task |
|
|
74
|
+
| `get_impact` | Blast radius — everything a change might break, before refactoring |
|
|
75
|
+
| `get_skeleton` | A file's full API surface at ~10% of its token cost |
|
|
76
|
+
| `remember` / `recall` | Durable project memory in `.oioxo/`, shared with the OIOXO IDEs |
|
|
77
|
+
|
|
78
|
+
## Commands
|
|
79
|
+
|
|
80
|
+
```
|
|
81
|
+
# Code
|
|
82
|
+
oioxo code "<task>" code in this repo: capsule-grounded, verified, then asks
|
|
83
|
+
before writing (--verify "<cmd>" · --yes · --max-iters · --local)
|
|
84
|
+
--local runs the built-in on-device coder, no key
|
|
85
|
+
|
|
86
|
+
# Account
|
|
87
|
+
oioxo login | logout connect / disconnect your OIOXO account
|
|
88
|
+
oioxo whoami | usage who you're signed in as · your saved-token allowance
|
|
89
|
+
oioxo status plan, savings and on-device index stats
|
|
90
|
+
|
|
91
|
+
# Devices (Compute Mesh) — build together on the same Wi-Fi, one account
|
|
92
|
+
oioxo invite show a code; the device that HAS the project scans it,
|
|
93
|
+
and this machine lends its coder to that build
|
|
94
|
+
oioxo join scan/paste the code from the device that has the project,
|
|
95
|
+
and lend this machine's compute to it
|
|
96
|
+
oioxo devices find your other same-account devices on this Wi-Fi
|
|
97
|
+
oioxo stop-helping how to stop lending (Ctrl+C in the helper's terminal)
|
|
98
|
+
|
|
99
|
+
# AI / model
|
|
100
|
+
oioxo model list | use <p> [m] show providers / pin one (and a model)
|
|
101
|
+
oioxo config set|get|list|unset persist provider/model/baseUrl/apiKey
|
|
102
|
+
|
|
103
|
+
# Agents (MCP)
|
|
104
|
+
oioxo init [--all] wire OIOXO into the AI agents in this project
|
|
105
|
+
oioxo mcp list show which agents OIOXO is wired into
|
|
106
|
+
oioxo serve run the MCP server over stdio (agents call this)
|
|
107
|
+
|
|
108
|
+
# Maintenance
|
|
109
|
+
oioxo doctor check creds, connection, coder config, agent wiring
|
|
110
|
+
oioxo update how to update the CLI
|
|
111
|
+
oioxo --version | --help
|
|
112
|
+
```
|
|
113
|
+
|
|
114
|
+
> The binary is published as `oioxo-mcp`; `oioxo …` and `oioxo-mcp …` are the same command.
|
|
115
|
+
|
|
116
|
+
## Pricing
|
|
117
|
+
|
|
118
|
+
- **Free** — a generous monthly saved-tokens allowance with any OIOXO account.
|
|
119
|
+
- **OIOXO Pro — $3.99/mo** — unlimited, across every agent, project and machine. → [oioxo.com](https://oioxo.com/?upgrade=pro)
|
|
120
|
+
|
|
121
|
+
---
|
|
122
|
+
|
|
123
|
+
*From the makers of the [OIOXO IDE](https://oioxo.com) — the AI editor that runs its models in your browser.*
|
|
124
|
+
|
|
125
|
+
© OIOXO · [oioxo.com](https://oioxo.com) · [Docs](https://oioxo.com/docs) · License: see LICENSE.md
|