Skip to content
Merged
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
12 changes: 8 additions & 4 deletions README.md
Original file line number Diff line number Diff line change
Expand Up @@ -12,7 +12,7 @@ Fork of [superagent-ai/grok-cli](https://github.com/superagent-ai/grok-cli) with

- **Ink React terminal UI** --- full markdown rendering with headers, bold, italic, tables, code blocks, lists, links, blockquotes. Vivid syntax highlighting for 25+ languages (Python, JavaScript, TypeScript, Rust, Go, Java, C/C++, Ruby, PHP, Bash, and more)
- **TOON compression** --- 30-50% token savings on all structured tool results
- **ai-memory MCP integration** --- persistent cross-session memory with vector search and auto-recall
- **Persistent memory via [ai-memory MCP](https://alphaonedev.github.io/ai-memory-mcp/)** --- AlphaOne's MCP-native memory server (97.8% R@5 on LongMemEval, pure SQLite FTS5, zero cloud dependencies). Session-scoped connections, auto-recall on startup, and compaction summary storage
- **Session-scoped MCP connections** --- connect once per session, not per message
- **MCP tools in all modes** --- memory works in plan, ask, and agent modes
- **Security hardening** --- AES-256-GCM storage encryption, MCP tool name collision prevention, description sanitization, 16 red team fixes
Expand Down Expand Up @@ -168,12 +168,16 @@ Full sub-agent instructions in [docs/user-settings-example.json](docs/user-setti

See [docs/CONFIGURATION.md](docs/CONFIGURATION.md) for the complete guide.

### 3. ai-memory (optional, recommended)
### 3. [ai-memory MCP](https://alphaonedev.github.io/ai-memory-mcp/) (optional, recommended)

Add persistent cross-session memory:
Add persistent cross-session memory via AlphaOne's MCP-native memory server.
Documentation: <https://alphaonedev.github.io/ai-memory-mcp/>

```bash
# Install ai-memory
# Install via Homebrew (recommended)
brew install alphaonedev/homebrew-tap/ai-memory

# Or one-line install
curl -fsSL https://raw.githubusercontent.com/alphaonedev/ai-memory-mcp/main/install.sh | bash
```

Expand Down
12 changes: 6 additions & 6 deletions docs/index.html
Original file line number Diff line number Diff line change
Expand Up @@ -4,7 +4,7 @@
<meta charset="UTF-8">
<meta name="viewport" content="width=device-width, initial-scale=1.0">
<title>grok-cli — AI Coding Agent Powered by xAI Grok | AlphaOne LLC</title>
<meta name="description" content="Open-source AI coding agent with TOON compression, persistent memory, security hardening, and 10 custom sub-agents. 30-50% token savings. Built with Bun and React Ink. By AlphaOne LLC.">
<meta name="description" content="Open-source AI coding agent with TOON compression, persistent memory via ai-memory MCP, security hardening, and 10 custom sub-agents. 30-50% token savings. Built with Bun and React Ink. By AlphaOne LLC.">
<link rel="preconnect" href="https://fonts.googleapis.com">
<link rel="preconnect" href="https://fonts.gstatic.com" crossorigin>
<link href="https://fonts.googleapis.com/css2?family=Inter:wght@400;500;600;700;800&display=swap" rel="stylesheet">
Expand Down Expand Up @@ -241,7 +241,7 @@ <h4>TOON Compression</h4>
</div>
<div class="feature">
<h4>Persistent Memory</h4>
<p>ai-memory MCP integration with session-scoped connections, auto-recall on startup, and compaction summary storage. Your agent remembers across sessions.</p>
<p>Powered by <a href="https://alphaonedev.github.io/ai-memory-mcp/"><strong>ai-memory MCP</strong></a> &mdash; AlphaOne's persistent memory server (97.8% R@5 on LongMemEval, pure SQLite FTS5, zero cloud dependencies). Session-scoped connections, auto-recall on startup, and compaction summary storage. Your agent remembers across sessions.</p>
</div>
<div class="feature">
<h4>Security Hardening</h4>
Expand Down Expand Up @@ -294,8 +294,8 @@ <h2>Full Configuration</h2>
}</pre></div>
<p style="color:var(--muted);font-size:0.85rem;margin-top:12px;">Full sub-agent instructions in <a href="https://github.com/alphaonedev/grok-cli/blob/main/docs/user-settings-example.json">user-settings-example.json</a>. See <a href="https://github.com/alphaonedev/grok-cli/blob/main/docs/CONFIGURATION.md">CONFIGURATION.md</a> for the complete guide.</p>

<h3 style="margin-top:32px;">ai-memory Integration (optional)</h3>
<p style="color:var(--muted);margin-bottom:12px;">Add persistent cross-session memory. Merge into the config above:</p>
<h3 style="margin-top:32px;"><a href="https://alphaonedev.github.io/ai-memory-mcp/">ai-memory MCP</a> Integration (optional)</h3>
<p style="color:var(--muted);margin-bottom:12px;">Add persistent cross-session memory via <a href="https://alphaonedev.github.io/ai-memory-mcp/">ai-memory</a>, AlphaOne's MCP-native memory server. Install with <code style="background:var(--surface);padding:2px 6px;border-radius:4px;">brew install alphaonedev/homebrew-tap/ai-memory</code>, then merge into the config above:</p>
<div class="config-block"><pre>{
<span class="key">"mcp"</span>: {
<span class="key">"servers"</span>: [{
Expand Down Expand Up @@ -346,7 +346,7 @@ <h2>Documentation</h2>
<a href="https://github.com/alphaonedev/grok-cli/blob/main/docs/HEADLESS_JSON_SPEC.md">Headless JSON Spec</a> &mdash; JSONL stream schema for <code>--format json</code> with jq cookbook<br>
<a href="https://github.com/alphaonedev/grok-cli/blob/main/docs/RELEASE_SIGNING.md">Release Signing</a> &mdash; macOS codesign + notarization setup<br>
<a href="https://github.com/alphaonedev/grok-cli/blob/main/docs/user-settings-example.json">Example Configuration</a> &mdash; copy-paste ready template<br>
<a href="https://github.com/alphaonedev/ai-memory-mcp/blob/main/docs/GROK_INTEGRATION.md">ai-memory Integration</a> &mdash; persistent memory setup<br>
<a href="https://alphaonedev.github.io/ai-memory-mcp/">ai-memory MCP</a> &mdash; persistent memory server (<a href="https://github.com/alphaonedev/ai-memory-mcp/blob/main/docs/GROK_INTEGRATION.md">grok-cli setup guide</a>)<br>
<a href="https://github.com/alphaonedev/grok-cli/blob/main/AGENTS.md">Sub-Agents Guide</a> &mdash; built-in and custom agents<br>
<a href="https://github.com/alphaonedev/grok-cli/releases">Releases</a> &middot;
<a href="https://github.com/alphaonedev/grok-cli/blob/main/CHANGELOG.md">Changelog</a>
Expand Down Expand Up @@ -379,7 +379,7 @@ <h2>Built with</h2>
Fork of <a href="https://github.com/superagent-ai/grok-cli">superagent-ai/grok-cli</a> &middot;
<a href="https://github.com/alphaonedev/grok-cli/blob/main/LICENSE">MIT License</a> &middot;
<a href="https://github.com/alphaonedev/grok-cli">GitHub</a> &middot;
<a href="https://github.com/alphaonedev/ai-memory-mcp">ai-memory</a>
<a href="https://alphaonedev.github.io/ai-memory-mcp/">ai-memory MCP</a>
</p>
</div>
</footer>
Expand Down
Loading