Test coverage: 87.4% 😍👌
- Durable context: automatically store agent's context
- Merge-safe concurrent writes: move fast with no fear
- Edits outsourced: slivingdoc concerns itself with storing, not writing
- Simple interface:
pullandcommit, the rest is handled magically - Your bucket or ours: any S3-compatible bucket, or a hosted space you can share with invite links
- Powerful yet simple ACL: you decide where agents can read, where they can write
- One binary: "batteries included", as they say
The docs cover
how it works,
the CLI and
configuration;
npx -y slivingdoc serve -h prints every flag.
Get started
Hosted. Sign in at slivingdoc.dev with GitHub or Google, create a token, and add the server to your agent:
claude mcp add slivingdoc \
--env SLIVINGDOC_TOKEN=<your-api-token> \
-- npx -y slivingdoc serve
Or skip the token: npx -y slivingdoc serve with no credential signs in on
first use. The first tool call answers with an approval page to open in the
browser, and every later server on the machine uses that login
(--login never turns this off).
Free for one space, 10 MB and 250,000 requests a month (pricing).
Self-hosted. Point it at an existing S3-compatible bucket that supports conditional writes.:
export AWS_REGION=eu-north-1
export AWS_ACCESS_KEY_ID=<key>
export AWS_SECRET_ACCESS_KEY=<key>
npx -y slivingdoc serve --bucket my-notes
No bucket yet? examples/seaweedfs/ runs one
locally in a container, and terraform/ provisions one on AWS.
As stdio MCP client
See MCP hosts for how to configure the MCP server in your agentic coder. The same system applies in the openai agent SDK (and any other LLM engine with MCP client support).
As CLI
"Install" it via npx:
npx -y slivingdoc version
npx fetches and verifies the native binary on first run. You can also
install the matching binary with the checksummed setup script:
curl -fsSL https://raw.githubusercontent.com/baalimago/slivingdoc/setup.sh | sh
It installs into $HOME/.local/bin (or /usr/local/bin when run as root).
slivingdoc login
slivingdoc pull notes
echo "hello from $(hostname)" > notes/hello.md
slivingdoc commit notes -m "First note"
Development
AGENTS.md is the developer guide and
architecture/ holds the contract, one concern
per file.
make qa # lint plus the full Go and npm test suites
License
MIT, see LICENSE. Third-party notices for the statically linked libgit2 are in NOTICE.
Not affiliated with Paris Hilton.
