Other clients + the Skills add-on
Two routes for hosts not covered by a dedicated guide:
- MCP — connect to the server’s
/mcpendpoint from any remote MCP client - Agent Skills — a markdown bundle compatible with agentskills.io, for clients that prefer skills over MCP (or want both)
Configure a host
Install the Go CLI binaries using the release installer and run novamem-init to detect and configure supported hosts. For a manual setup, add the endpoint and bearer shown below.
MCP — generic config
Remote MCP (recommended)
For any host that supports remote MCP over SSE:
{
"mcpServers": {
"novamem": {
"type": "http",
"url": "http://localhost:7778/mcp",
"headers": { "Authorization": "Bearer nm_..." }
}
}
}Confirmed working with: Claude Code, Claude Desktop, Cursor, Kilo Code, Goose, OpenCode, Continue (recent builds), Cline, Roo Code.
The Go installer configures hosts that require stdio with the novamem-mcp binary shipped alongside novamem-init. For hosts that support remote MCP, use /mcp directly as above.
Agent Skills add-on
If your client supports the Agent Skills format — Goose, OpenCode, OpenHands, Junie, Roo Code, Factory, and a growing list — you can drop the bundled skill into the client's skills directory alongside or instead of the MCP server.
The skill teaches the agent when to call the tools and how to phrase saves; MCP exposes the tools themselves. With both, the skill loads at startup (~100 tokens for name + description), expands on demand, and the agent calls memory_* / project_* over MCP.
Layout
The bundle lives at skills/novamem/ and follows the agentskills.io spec:
skills/novamem/
├── SKILL.md # name, description, when-to-use rules
└── references/
├── search.md # memory_search / recent / today / neighbors / stats
├── remember.md # memory_capture / remember / update / forget + worthiness gate
└── projects.md # all 7 project_* toolsInstall
Most clients want a copy or symlink under <workspace>/skills/ or ~/.config/<agent>/skills/. Examples:
# Goose
cp -r skills/novamem ~/.config/goose/skills/
# OpenCode (project-scoped)
cp -r skills/novamem .opencode/skills/
# Generic — symlink works for any client that scans a skills dir
ln -s "$(pwd)/skills/novamem" ~/.skills/novamemCheck your client's docs for the exact path — the agentskills.io client list links each one.
Validate
npx -y skills-ref validate ./skills/novamemThis checks the SKILL.md frontmatter and naming conventions.
Build your own integration
For a host without dedicated docs:
- Mint a
nm_…bearer from the dashboard's API Tokens page. - Configure the host to use the server’s
/mcpendpoint. The Go installer handles hosts that require stdio. - Optionally drop the Skills bundle in the client's skills directory for richer behaviour rules.
- If your client speaks neither MCP nor Skills, use the HTTP API directly — the OpenAPI spec covers every operation.
If you wire up a new client, a PR adding it to this directory is welcome.