Skip to content

README.md

Latest commit

 

History

History
167 lines (111 loc) · 5.94 KB

README.md

File metadata and controls

167 lines (111 loc) · 5.94 KB

OrbCode — MatterAI Plugin for Claude Code

License: MIT Node.js >= 20 Marketplace

OrbCode supercharges Claude Code with semantic code search, prompt optimisation, analytics, and cost savings — all powered by MatterAI.

Features

Feature What it does
Semantic Code Search Ask Claude to find code naturally (semantic_code_search MCP tool). Indexes your entire workspace into a vector store for fast, relevance-ranked lookups.
Prompt Optimisation Every request is routed through MatterAI's orbinference API to refine prompts before they hit Anthropic — improving quality and reducing token waste.
Cost Analytics Track inference spend, token usage, and model routing decisions in real time via the MatterAI dashboard.
Cost Savings Smart body and header modifications reduce redundant API calls and cut overall Claude Code inference costs.
Local Proxy Lightweight HTTP proxy (127.0.0.1:7856) auto-starts on every Claude Code session. Zero manual env setup.
Codebase Indexer Background file watcher indexes your repo automatically after login. Supports incremental updates as you edit.

How It Works

OrbCode runs a lightweight local proxy that intercepts every Anthropic API call:

Claude Code  →  Local Proxy (port 7856)  →  api.matterai.so/v1/orbinference
                                                     ↓
                                             Modified body + headers
                                                     ↓
                                              Anthropic API
                                                     ↓
                                    Claude Code  ←  Response

Before each inference call, the full request (messages, model, tools, headers) is sent to MatterAI's orbinference API. MatterAI returns potentially modified body and headers, which are then used to make the actual Anthropic call.

Getting Started

1. Install

From inside a Claude Code session:

/plugin marketplace add MatterAIOrg/orbcode
/plugin install orb@matterai-marketplace

2. Setup

Run the setup command:

/orb-setup

This does three things in one shot:

  • Starts the local proxy daemon on port 7856
  • Opens your browser to authenticate with MatterAI (skipped if already logged in)
  • Starts the codebase indexer in the background after auth

ANTHROPIC_BASE_URL is set automatically by the plugin's settings.json — no shell-profile edits required.

Headless / SSH? Pass the token directly:

/orb-setup --token '<your-access-token>'

3. Restart Claude Code

Quit your current session and launch Claude Code again:

claude

4. Verify

Run /orb-status to check everything is connected:

/orb-status

You should see:

  • Authentication: ✅ Logged in
  • Proxy: ✅ Running
  • ANTHROPIC_BASE_URL: ✅ Set

Commands

Command Description
/orb-setup Full bootstrap — starts proxy, authenticates, starts indexer
/orb-login Re-authenticate (used when logged out or token expired)
/orb-logout Clear stored credentials
/orb-status Check auth & proxy status
/orb-update Update to latest plugin version
/reload-plugins Reload plugins after updates

Architecture

Local Proxy (scripts/orb-proxy.js)

A Node.js HTTP server running on 127.0.0.1:7856 that:

  1. Receives Anthropic API requests from Claude Code (via ANTHROPIC_BASE_URL)
  2. Sends the complete request (body + headers) to api.matterai.so/v1/orbinference
  3. Receives modified body + headers from MatterAI
  4. Forwards the modified request to the real Anthropic API
  5. Streams the response back to Claude Code

The proxy auto-starts on each Claude Code session via the SessionStart hook.

Authentication

Tokens are stored in ~/.claude/orbcode/auth.json and used as Bearer tokens for the orbinference API.

Environment

Variable Purpose
ANTHROPIC_BASE_URL Points Claude Code to the local proxy — set automatically via the plugin's settings.json env block; applied on each Claude Code session start
CLAUDE_PLUGIN_ROOT Set automatically by Claude Code

Development

Load the plugin from a local directory:

claude --plugin-dir /path/to/orbcode

Make sure ANTHROPIC_BASE_URL is set in your env for the proxy to work:

export ANTHROPIC_BASE_URL=http://127.0.0.1:7856
claude --plugin-dir /path/to/orbcode

Requirements

  • Node.js >= 20
  • Claude Code
  • MatterAI account

Contributing

We welcome contributions! Please read our Contributing Guide and Code of Conduct before opening issues or pull requests.

Security

If you discover a security vulnerability, please follow our Security Policy and report it privately to support@matterai.so.

Changelog

See CHANGELOG.md for a history of changes.

License

MIT

Support