oioxo-mcp 0.1.3 → 0.1.6

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/LICENSE.md ADDED
@@ -0,0 +1,35 @@
1
+ # OIOXO License
2
+
3
+ Copyright © 2026 OIOXO (oioxo.com). All rights reserved.
4
+
5
+ This software ("oioxo-mcp", the OIOXO context engine, and the OIOXO companion
6
+ extensions) is proprietary software, licensed — not sold.
7
+
8
+ ## You may
9
+
10
+ - Install and use the software, free of charge, with an OIOXO account, subject
11
+ to the plan limits of that account (Free allowances, OIOXO Pro entitlements).
12
+ - Use it on any number of your own machines and projects.
13
+
14
+ ## You may not
15
+
16
+ - Modify, fork, patch, or create derivative works of the software.
17
+ - Reverse engineer, decompile, or deobfuscate the software, except where such
18
+ restriction is prohibited by applicable law.
19
+ - Circumvent, disable, or interfere with the plan/entitlement checks, usage
20
+ metering, or any other technical limitation.
21
+ - Redistribute, sublicense, sell, or offer the software as a service.
22
+
23
+ ## Privacy
24
+
25
+ The engine indexes and processes your code 100% on your device. Your code is
26
+ never uploaded. Only metering counts (e.g. saved-token totals) and account
27
+ credentials are exchanged with oioxo.com.
28
+
29
+ ## No warranty
30
+
31
+ THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
32
+ IMPLIED. IN NO EVENT SHALL OIOXO BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
33
+ LIABILITY ARISING FROM THE USE OF THE SOFTWARE.
34
+
35
+ Full terms: https://oioxo.com/terms
package/README.md CHANGED
@@ -1,8 +1,10 @@
1
- # OIOXO — context engine for AI coding agents
1
+ # OIOXO — Context Engine for AI Coding Agents
2
2
 
3
- OIOXO feeds Claude Code, GitHub Copilot, Cursor and any MCP-capable agent the **minimal relevant slice** of your codebase — the exact code in play plus the API surface of its real dependencies — instead of letting the agent read whole files. Typical result: the same answer for **10-20× fewer tokens**, so your API keys and subscriptions go much further.
3
+ **Your AI agents read 10× more code than they need. You pay for every token of it.**
4
4
 
5
- Everything runs **100% on your device**. Your code is never uploadedonly the *count* of tokens you saved is reported to your OIOXO account for metering.
5
+ OIOXO sits between your codebase and your AI agents GitHub Copilot, Claude Code, Cursor, Windsurf, Gemini CLI, Codex and hands them the *minimal relevant slice* of your project instead of letting them read whole files.
6
+
7
+ **Measured on a real production codebase: 90–92% fewer context tokens per question.** A question that costs an agent ~50,000 tokens of file reading comes back as a ~5,000-token capsule — same answer, a fraction of the cost.
6
8
 
7
9
  ## Quick start
8
10
 
@@ -15,43 +17,48 @@ oioxo-mcp init # wire OIOXO into the agents in this project
15
17
 
16
18
  Restart your agent. From the next prompt on, it calls OIOXO before reading files.
17
19
 
18
- `init` detects Claude Code (`.mcp.json`), VS Code / Copilot (`.vscode/mcp.json`) and Cursor (`.cursor/mcp.json`), and **merges** into existing configs your other MCP servers are untouched.
19
-
20
- ## What the agent gets
21
-
22
- | Tool | What it does |
23
- |---|---|
24
- | `get_context` | The main event: BM25 retrieval + import-graph expansion → anchors in full, dependencies as signatures only. |
25
- | `get_skeleton` | One file's API surface without implementation bodies. |
26
- | `get_impact` | Blast radius: what a file imports, and everything that imports it. |
27
- | `remember` / `recall` | Durable project memory in `.oioxo/` — shared with the OIOXO IDEs. |
20
+ 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.
28
21
 
29
- ## Plans
22
+ ## Why developers use it
30
23
 
31
- The context engine is part of your OIOXO account:
24
+ - 💸 **Subscriptions go further** Copilot premium requests, Claude limits, API keys all burn down slower.
25
+ - ⚡ **Better answers** — focused context beats 75k tokens of noise; the capsule holds the exact code in play plus the API surface of its real dependencies.
26
+ - 🔒 **100% on-device** — your code is indexed and queried locally, never uploaded. Only the saved-token *count* is metered.
27
+ - 🪄 **One command** — `init` detects Claude Code, VS Code/Copilot, Cursor, Windsurf, Gemini CLI and Codex, and merges their configs without touching your other MCP servers.
32
28
 
33
- - **OIOXO Free** — a monthly saved-tokens allowance to feel the difference.
34
- - **OIOXO Pro** — unlimited, across every agent and every project → [oioxo.com](https://oioxo.com/?upgrade=pro)
29
+ ## How it works
35
30
 
36
- Plan checks are server-side; `oioxo-mcp status` shows your remaining allowance, plan and index stats.
31
+ 1. **Index** in-memory, on-device, seconds. No model, no GPU, no upload.
32
+ 2. **Anchor** — BM25 retrieval finds the exact code in play for the task.
33
+ 3. **Expand** — the import graph pulls in real dependencies, rejecting same-words-only decoys.
34
+ 4. **Compress** — anchors ship as full code; neighbors ship as signatures only.
37
35
 
38
- ## How it works
36
+ ## Tools your agent gets
39
37
 
40
- 1. **Index** your project is chunked and BM25-indexed in memory (~1500 files max, deps/build output excluded). No model, no GPU, instant and offline.
41
- 2. **Anchor** — a task query retrieves the highest-confidence chunks.
42
- 3. **Expand** the import graph pulls in the files the anchors *actually depend on* (and their callers), rejecting files that merely share words.
43
- 4. **Compress** anchors ship as full code, neighbors ship as signatures. That asymmetry is the saving.
38
+ | Tool | What it does |
39
+ |---|---|
40
+ | `get_context` | The minimal relevant slice of the codebase for any task |
41
+ | `get_impact` | Blast radius everything a change might break, before refactoring |
42
+ | `get_skeleton` | A file's full API surface at ~10% of its token cost |
43
+ | `remember` / `recall` | Durable project memory in `.oioxo/`, shared with the OIOXO IDEs |
44
44
 
45
45
  ## Commands
46
46
 
47
47
  ```
48
48
  oioxo-mcp login connect your OIOXO account
49
- oioxo-mcp init [--all] write agent MCP configs ( --all = every supported agent )
49
+ oioxo-mcp init [--all] write agent MCP configs + instruction files
50
50
  oioxo-mcp serve run the MCP server (agent configs call this)
51
51
  oioxo-mcp status plan, savings and index stats
52
52
  oioxo-mcp logout remove the stored credential
53
53
  ```
54
54
 
55
+ ## Pricing
56
+
57
+ - **Free** — a generous monthly saved-tokens allowance with any OIOXO account.
58
+ - **OIOXO Pro — $3.99/mo** — unlimited, across every agent, project and machine. → [oioxo.com](https://oioxo.com/?upgrade=pro)
59
+
55
60
  ---
56
61
 
57
- © OIOXO · [oioxo.com](https://oioxo.com)
62
+ *From the makers of the [OIOXO IDE](https://oioxo.com) — the AI editor that runs its models in your browser.*
63
+
64
+ © OIOXO · [oioxo.com](https://oioxo.com) · [Docs](https://oioxo.com/docs) · License: see LICENSE.md