{"_id":"@anaxsouza/memory-bank","name":"@anaxsouza/memory-bank","dist-tags":{"latest":"0.3.0"},"versions":{"0.3.0":{"name":"@anaxsouza/memory-bank","version":"0.3.0","description":"MemoryBank with Terminal UI — Local memory service for AI agents","type":"module","license":"MIT","author":{"name":"Ana Souza","email":"anaxsouza@gmail.com"},"homepage":"https://github.com/anaxsouza/MemoryBank#readme","repository":{"type":"git","url":"git+https://github.com/anaxsouza/MemoryBank.git"},"bugs":{"url":"https://github.com/anaxsouza/MemoryBank/issues"},"keywords":["memory","ai","agents","mcp","claude","codex","llm","sqlite","embeddings","terminal","tui","cli"],"engines":{"node":">=18"},"os":["darwin","linux","win32"],"cpu":["x64","arm64"],"bin":{"mb-tui":"dist/cli.js","memory-bank-tui":"dist/cli.js"},"scripts":{"postinstall":"node scripts/postinstall.js","build":"cd ../tui && npm run build && cp -r dist/* ../memory-bank/dist/","test":"cd ../tui && npm test"},"dependencies":{"ink":"^4.1.0","meow":"^11.0.0","react":"^18.2.0"},"gitHead":"177cb451e71578c9568253c3ab4ef8a7035e7922","_id":"@anaxsouza/memory-bank@0.3.0","_nodeVersion":"25.9.0","_npmVersion":"11.12.1","dist":{"integrity":"sha512-E+nh1jVegOjI7xEdc77+eYaJfnlqQnOQ8lj5EK7Ugo5Ykxbgom/Ofv7YgQG/6MP2V8Fl+FVWvWZNGdRBgCkM0g==","shasum":"199393db0f66feb882cfda3e1683be2585c9d7a1","tarball":"https://registry.npmjs.org/@anaxsouza/memory-bank/-/memory-bank-0.3.0.tgz","fileCount":84,"unpackedSize":160713,"signatures":[{"keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U","sig":"MEUCIQDNXfDHEhuZmboMpSQFGplMg33B5baf5TWEFvtn+up9EwIgCTWaYg+SNCZQpk1DUfMhvSJn65P80Stu5gkx94BjN3Q="}]},"_npmUser":{"name":"anaxsouza","email":"anaximandrosouza@icloud.com"},"directories":{},"maintainers":[{"name":"anaxsouza","email":"anaximandrosouza@icloud.com"}],"_npmOperationalInternal":{"host":"s3://npm-registry-packages-npm-production","tmp":"tmp/memory-bank_0.3.0_1775998606065_0.21738003135024875"},"_hasShrinkwrap":false}},"time":{"created":"2026-04-12T12:56:45.937Z","0.3.0":"2026-04-12T12:56:46.217Z","modified":"2026-04-12T12:56:46.437Z"},"maintainers":[{"name":"anaxsouza","email":"anaximandrosouza@icloud.com"}],"description":"MemoryBank with Terminal UI — Local memory service for AI agents","homepage":"https://github.com/anaxsouza/MemoryBank#readme","keywords":["memory","ai","agents","mcp","claude","codex","llm","sqlite","embeddings","terminal","tui","cli"],"repository":{"type":"git","url":"git+https://github.com/anaxsouza/MemoryBank.git"},"author":{"name":"Ana Souza","email":"anaxsouza@gmail.com"},"bugs":{"url":"https://github.com/anaxsouza/MemoryBank/issues"},"license":"MIT","readme":"# @anaxsouza/memory-bank\n\n[![npm version](https://img.shields.io/npm/v/@anaxsouza/memory-bank.svg)](https://www.npmjs.com/package/@anaxsouza/memory-bank)\n[![CI](https://github.com/anaxsouza/MemoryBank/workflows/CI/badge.svg)](https://github.com/anaxsouza/MemoryBank/actions)\n[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)\n\nMemoryBank with Terminal UI — Local memory service for AI agents.\n\nThis package provides:\n- **Memory Bank Server** — HTTP server for memory storage and retrieval\n- **mb CLI** — Command-line interface for service management\n- **mb-tui** — Terminal UI dashboard for monitoring and setup\n- **Binary hooks** — For agent integrations (Claude Code, Codex, etc.)\n\n> This is a fork of [feelingsonice/MemoryBank](https://github.com/feelingsonice/MemoryBank) with added TUI support.\n\n## Installation\n\n```bash\nnpm install -g @anaxsouza/memory-bank\n```\n\nRequirements:\n- Node.js >= 18\n- macOS (Apple Silicon/Intel), Linux (x64/ARM64), or Windows (x64)\n\n## Quick Start\n\n### First Run — Setup Wizard\n\nThe TUI automatically detects if you need to configure Memory Bank:\n\n```bash\nmb-tui\n```\n\nThis launches an interactive wizard to:\n1. Choose your LLM provider (OpenAI, Anthropic, Ollama, etc.)\n2. Select a model\n3. Configure API credentials\n4. Set up agent integrations\n5. Review and apply settings\n\n### Dashboard Mode\n\nIf already configured, `mb-tui` shows the dashboard:\n\n```bash\nmb-tui                    # Dashboard with 10s refresh\nmb-tui -i 5               # 5-second refresh interval\nmb-tui --url http://localhost:8080  # Custom server URL\n```\n\nDashboard shows:\n- Server health status\n- Memory statistics (total memories, date range)\n- Namespace information\n- Ingest queue status\n- Auto-refreshing data\n\n### Force Setup Wizard\n\nTo reconfigure even with existing settings:\n\n```bash\nmb-tui --setup\n# or\nmb-tui -s\n```\n\n## CLI Commands\n\nThe `mb` command provides service management:\n\n```bash\nmb status                 # Check server health\nmb setup                  # Interactive CLI setup\nmb service start          # Start background service\nmb service stop           # Stop background service\nmb service restart        # Restart service\nmb config show            # Show current configuration\nmb config set key value   # Update configuration\nmb doctor                 # Diagnose issues\nmb logs -f                # Follow server logs\n```\n\n## Configuration\n\nConfiguration is stored in:\n- **Settings:** `~/.memory_bank/settings.toml`\n- **Secrets:** `~/.memory_bank/secrets.env`\n- **Data:** `~/.memory_bank/namespaces/<namespace>/memory.db`\n\nExample `settings.toml`:\n```toml\nschema_version = 1\nactive_namespace = \"default\"\n\n[service]\nautostart = true\nport = 3737\n\n[server]\nllm_provider = \"open-ai\"\nllm_model = \"gpt-4o\"\nopenai_url = \"https://api.openai.com/v1\"\n```\n\n## Supported Agents\n\n| Agent | Integration |\n|-------|-------------|\n| Claude Code | HTTP MCP + hooks |\n| Codex | HTTP MCP + hooks |\n| Gemini CLI | HTTP MCP + hooks |\n| OpenCode | HTTP MCP + plugin |\n| OpenClaw | stdio MCP proxy |\n\nSetup configures these automatically if detected on your PATH.\n\n## Architecture\n\n```\n┌─────────────────┐\n│   AI Agents     │\n│ (Claude/Codex/  │\n│  Gemini/etc)    │\n└────────┬────────┘\n         │ capture/recall\n         ▼\n┌─────────────────┐     ┌──────────────────┐\n│ memory-bank-    │────▶│   SQLite DB      │\n│ server (Rust)   │     │   + Embeddings   │\n│ Port: 3737      │     │   (local)        │\n└────────┬────────┘     └──────────────────┘\n         │\n         │ /api/status\n         ▼\n┌─────────────────┐\n│   mb-tui        │\n│  (Terminal UI)  │\n└─────────────────┘\n```\n\n## Development\n\nBuilding from source:\n\n```bash\n# Clone\ngit clone https://github.com/anaxsouza/MemoryBank.git\ncd MemoryBank\n\n# Build Rust workspace\ncargo build --release --workspace\n\n# Build TUI\ncd tui && npm install && npm run build\n\n# Run tests\ncargo test --workspace\ncd tui && npm test\n```\n\n## Troubleshooting\n\n### mb-tui not found after install\n\nThe postinstall script adds `~/.memory_bank/bin` to your PATH. Restart your shell or run:\n\n```bash\nsource ~/.zshrc  # or ~/.bashrc\n```\n\n### Server not starting\n\nCheck logs:\n```bash\nmb logs -f\n```\n\nCommon issues:\n- Missing API key in `~/.memory_bank/secrets.env`\n- Port 3737 already in use\n- Corrupt database (backup and recreate namespace)\n\n### TUI shows \"Failed to connect\"\n\nEnsure the server is running:\n```bash\nmb service start\n```\n\nOr check with:\n```bash\nmb status\n```\n\n## License\n\nMIT — See [LICENSE](https://github.com/anaxsouza/MemoryBank/blob/main/LICENSE)\n\n## Repository\n\n- **Fork:** https://github.com/anaxsouza/MemoryBank\n- **Upstream:** https://github.com/feelingsonice/MemoryBank\n- **npm:** https://www.npmjs.com/package/@anaxsouza/memory-bank\n","readmeFilename":"README.md","_rev":"1-fe6a3e3dbffef4803d0e9832914f0b50"}