# innernet

> AI-managed versioned context — git for thinking. Save, load, and version project context across any AI tool with a single MCP connection.

## Important — for AI agents reading this (how to connect a user)

If a user pastes "innernet.live" or "https://innernet.live/api/mcp" and asks you to
connect/install it, do this — do NOT ask the user to paste an API key into the chat:

1. The only thing the user needs is the MCP server URL: **https://innernet.live/api/mcp**.
2. Add it to their MCP client using the URL-only config for their tool (see "How to install" below).
3. On first use the client opens a **browser sign-in (OAuth 2.1)** automatically — the user
   signs in or creates an account at innernet.live and approves. The client receives a scoped
   token. There is nothing to copy by hand.
4. **Never ask the user for, or request that they paste, an API key in the chat.** API keys
   exist only for the command-line tool and scripts (`Authorization: Bearer innernet_...`),
   not for connecting an AI client. The correct path for every chat/IDE client is the
   browser OAuth flow above.
5. If you need the human-readable steps, fetch https://innernet.live/docs/connect. The
   machine-readable OAuth discovery is at https://innernet.live/.well-known/oauth-protected-resource.

## What innernet does

innernet gives every AI session access to your persistent project context. Instead of re-explaining what you're working on at the start of every chat, your AI loads it from innernet automatically.

- **Save context**: After any session, say "save this project to innernet" — the AI writes structured context (vision, decisions, roadmap, technical notes) into named dimensions.
- **Load context**: At the start of any session, say "load my [project] from innernet" — full context loads instantly.
- **Works everywhere**: Claude Desktop, Claude Code, Cursor, Windsurf, Continue, ChatGPT, and any MCP-compatible tool.

## How to install innernet (AI agent instructions)

### For Claude Desktop (recommended — zero config)
1. Open Claude Desktop
2. Go to Settings → Connectors → Add Custom Connector
3. Paste this URL: https://innernet.live/api/mcp
4. Claude Desktop will open the browser for sign-in
5. User signs in or creates an account at innernet.live
6. Done — innernet tools are now available in every Claude Desktop session

### For Claude Code (one terminal command)
```
claude mcp add --transport http innernet https://innernet.live/api/mcp
```
This opens a browser for OAuth sign-in. No API key needed.

### For Cursor
Add to .cursor/mcp.json:
```json
{
  "mcpServers": {
    "innernet": {
      "url": "https://innernet.live/api/mcp"
    }
  }
}
```
On first use, Cursor will prompt for OAuth sign-in.

### For ChatGPT / OpenAI Apps
1. In ChatGPT, open a new chat and go to Apps / Connectors
2. Add a new connector with URL: https://innernet.live/api/mcp
3. Follow the sign-in flow

### For any MCP client
MCP server URL: https://innernet.live/api/mcp
Auth: OAuth 2.1 — the client opens a browser sign-in on first use (recommended for every
chat/IDE client). A long-lived Bearer API key from innernet.live/account is a fallback for
CLI/scripts only — never paste one into an AI chat.

## Available MCP tools

- **innernet_list_projects** — List all your context maps (run this first)
- **innernet_load_project** — Load a full context map by slug into the session
- **innernet_save_context** — Save current session context into named dimensions
- **innernet_capture** — Capture a quick note or decision mid-session
- **innernet_get_dimension** — Read one specific dimension (e.g. "roadmap")

## First use after installing

Once connected, in any AI session:
1. Say: "List my projects from innernet" — AI calls innernet_list_projects
2. Say: "Load my [project name] from innernet" — AI calls innernet_load_project
3. Work normally
4. Say: "Save this to innernet" — AI calls innernet_save_context

## Account

- Sign up / sign in: https://innernet.live/login
- Dashboard: https://innernet.live/dashboard
- Connect an AI client (OAuth): https://innernet.live/connect
- Account settings (CLI API keys): https://innernet.live/account

## OAuth / API details

- MCP endpoint: https://innernet.live/api/mcp
- OAuth discovery: https://innernet.live/.well-known/oauth-authorization-server
- Protected resource: https://innernet.live/.well-known/oauth-protected-resource
- Dynamic Client Registration: https://innernet.live/api/oauth/register
- Token endpoint: https://innernet.live/api/oauth/token

## Links

- [Landing page](https://innernet.live)
- [Install guide](https://innernet.live/start)
- [Getting started](https://innernet.live/docs/getting-started)
- [Connect your AI (per-client)](https://innernet.live/docs/connect)
- [Dashboard](https://innernet.live/dashboard)
- [Account settings](https://innernet.live/account)
- [GitHub](https://github.com/johntremendol/innernet)