Skip to content

Commit 6d2d0ed

Browse files
committed
docs: add Asterisk integration guide to INTEGRATIONS.md
Covers three integration paths — MCP server, Ollama proxy, and REST API with soul/hooks — plus Telegram/WhatsApp bot support.
1 parent 7958f66 commit 6d2d0ed

1 file changed

Lines changed: 55 additions & 0 deletions

File tree

docs/INTEGRATIONS.md

Lines changed: 55 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -597,6 +597,61 @@ async function withMemory(
597597

598598
---
599599

600+
## Asterisk
601+
602+
[Asterisk](https://github.com/ayvazyan10/asterisk) is a lightweight, open-source AI agent CLI built on Bun. By default, its conversation history lives in memory and is lost on restart. Three integration paths give Asterisk persistent memory via Engram.
603+
604+
See the [engram.am Asterisk docs](https://engram.am/docs/asterisk) for full setup instructions with examples.
605+
606+
### Option AMCP Server (recommended)
607+
608+
Asterisk has full MCP client support. Add Engram as an MCP server in `~/.asterisk/config.json`:
609+
610+
```json
611+
{
612+
"mcpServers": [
613+
{
614+
"name": "engram",
615+
"transport": "stdio",
616+
"command": "node",
617+
"args": ["/path/to/neuralcore/packages/mcp/dist/server.js"],
618+
"env": {
619+
"ENGRAM_DB_PATH": "/path/to/engram.db"
620+
}
621+
}
622+
]
623+
}
624+
```
625+
626+
Restart Asterisk. All 18 Engram tools appear as `engram__store_memory`, `engram__recall_context`, etc. The agent can store and recall memories as part of normal conversation.
627+
628+
If Engram is already configured for Claude Code, use the same `server.js` path and databaseboth tools share the same brain.
629+
630+
### Option BOllama Proxy (zero config)
631+
632+
If Asterisk uses Ollama as its provider, point it at the Engram Ollama proxy instead. In `~/.asterisk/config.json`:
633+
634+
```json
635+
{
636+
"provider": "ollama",
637+
"ollama": {
638+
"baseUrl": "http://localhost:11435"
639+
}
640+
}
641+
```
642+
643+
The proxy intercepts every request, injects relevant memories into the system prompt, and auto-stores conversations as episodic memories. No MCP configuration or tool calls needed.
644+
645+
### Option CREST API + Soul/Hooks
646+
647+
For maximum control, add memory recall/store instructions to Asterisk's soul system (`~/.asterisk/SOUL.md`) and use lifecycle hooks in `~/.asterisk/config.json` to auto-store exchanges after each turn. This works regardless of provider (Ollama or Anthropic).
648+
649+
### Telegram & WhatsApp bots
650+
651+
When Asterisk runs in daemon mode with bot transports enabled, each bot session uses the same provider configuration. If you configured the Ollama proxy (Option B), bot conversations automatically gain memory. If you configured MCP (Option A), the agent has memory tools in bot sessions too.
652+
653+
---
654+
600655
## Custom integrations (REST)
601656

602657
Any application can integrate with Engram directly via HTTP.

0 commit comments

Comments
 (0)