# oneda [Health: Active]

**Category:** 🧠 Knowledge & Memory  
**Repository:** https://github.com/nova-oneda/cli  
**GitHub Stars:** 0  
**Views:** 0  
**Installs:** 0  
**Upvotes:** 0  
**Directory Page:** https://allmcps.com/mcp/oneda-2

## Description
Persistent, governed institutional memory for Claude Code — specs, decisions, learnings.

## Claude Desktop Quick Installation
Heuristic fallback — verify the package name and runner against the repository README before running it. Uses `npx` (confidence: low):

```json
"mcpServers": {
  "oneda": {
    "command": "npx",
    "args": ["-y","oneda-2"]
  }
}
```

## Documentation & README

# Nova Oneda CLI

[![npm version](https://img.shields.io/npm/v/@nova-oneda/cli.svg)](https://www.npmjs.com/package/@nova-oneda/cli)
[![license](https://img.shields.io/npm/l/@nova-oneda/cli.svg)](LICENSE)
[![node](https://img.shields.io/node/v/@nova-oneda/cli.svg)](package.json)

Persistent, governed institutional memory for Claude Code — connect Nova Oneda's MCP server in one command.

Claude Code forgets everything between sessions. Ask it to build a new feature six weeks after you decided "we're not using Redux, we tried it in Q2 and it caused more bugs than it fixed" and it'll cheerfully suggest Redux again. Nova Oneda gives Claude Code that memory back — it pulls relevant past decisions and context automatically before substantial work, and records new ones as you go, so institutional knowledge survives context resets, session restarts, and team turnover.

<!--
  Demo placeholder — record a short terminal GIF (asciinema → gif, or a
  screen capture) showing: (1) `nova-oneda setup --key ...` connecting in
  Claude Code, (2) asking Claude something whose answer depends on a past
  decision Nova Oneda already knows, (3) Claude answering correctly by
  citing that memory instead of guessing. That's the single moment that
  sells the tool — lead with it, above the Install section.
-->

## Install

```bash
npm install -g @nova-oneda/cli
```

Requires Node.js 18+ and [Claude Code](https://claude.com/claude-code) already installed.

## Get an API key

Nova Oneda accounts are free to create, and new accounts get 50 free AI-assisted memory calls before you ever need to connect your own Anthropic key:

1. Sign up at **[oneda.freeelatech.com](https://oneda.freeelatech.com)**
2. Open the **API Keys** page and create a key (starts with `nv_live_`)

## Setup

```bash
nova-oneda setup --key nv_live_...
```

Or set it once as an environment variable and omit `--key` on every run:

```bash
export NOVA_MEMORY_API_KEY=nv_live_...
nova-oneda setup
```

This validates the key, confirms Claude Code is installed, registers Nova Oneda as an MCP server in your Claude Code config, and stores the key locally so you don't need to pass it again.

## Commands

| Command | What it does |
|---|---|
| `nova-oneda setup --key <key>` | Configure Nova Oneda in Claude Code |
| `nova-oneda doctor` | Check that your key and Claude Code connection are healthy |
| `nova-oneda uninstall` (alias `remove`) | Remove Nova Oneda from Claude Code and delete the local credential |

## Where your key is stored

- **macOS** — system Keychain, via the built-in `security` tool
- **Linux** — Secret Service (libsecret), via `secret-tool`, when available
- **Everywhere else** — an AES-256-GCM encrypted file under `~/.nova-oneda/`, mode `0600`

Your key is never written to a plaintext file or checked into any project directory.

## Once connected

Just use Claude Code normally. Nova Oneda works automatically in the background — pulling relevant memory before substantial work, and recording decisions when you ask it to ("Remember that we chose Postgres for billing, in Nova Oneda"). See [oneda.freeelatech.com](https://oneda.freeelatech.com) after signing in for the full list of what you can ask it to do.

## Uninstalling

```bash
nova-oneda uninstall
```

This removes Nova Oneda from Claude Code and deletes your locally stored key. Your account and everything Nova Oneda has already remembered stay available at [oneda.freeelatech.com](https://oneda.freeelatech.com) — this only removes the local connection.

## License

MIT