# Introduction

> What slivingdoc is, its two operations, who it is for, and where to go next.

Canonical URL: https://www.slivingdoc.dev/docs/ · Version: 0.1 · Updated: 2026-09-21

Full site index: https://www.slivingdoc.dev/llms.txt

slivingdoc is a distributed, durable notebook built for high-scale agents.
A server exposes it over the Model Context Protocol (MCP), and the same
two operations are available directly to humans from the command line, so
agents and people can share one notebook without agreeing on a protocol
between them: they read and write the same files with the tools they
already have.

Notes live in an S3-compatible bucket. Concurrent writers never overwrite
one another's accepted work — a commit that conflicts with the remote
state returns the conflict instead of silently losing it. See
[Guarantees and limits](/docs/concepts/guarantees/) for the accepted
contract behind that claim.

## The two operations

| Operation | MCP tool       | CLI command | Effect                                                                            |
| --------- | -------------- | ----------- | --------------------------------------------------------------------------------- |
| Pull      | `notes_pull`   | `pull`      | Write the current notebook into a directory.                                      |
| Commit    | `notes_commit` | `commit`    | Publish local changes, merging in any concurrent, non-conflicting remote changes. |

An MCP server takes its own private notebook directory by default, so
nothing has to be configured or coordinated between agents; a fixed,
shared directory is also available for humans and agents to edit
together. See [Connect an MCP host](/docs/guides/mcp-hosts/) and
[Use the CLI without a host](/docs/guides/cli/).

## Who it is for

- **Agentic harnesses** that want a shared, durable place for agents to
  keep notes, plans, or a shared knowledge base, reachable over MCP with
  no server of your own to run.
- **Fleets of agents** working from one bucket, where conflicting writes
  must be caught rather than silently dropped.
- **Humans and agents sharing a directory**, editing the same files with
  whatever tools they already use.

## Where to go next

- New to slivingdoc? Start with [Quickstart](/docs/quickstart/).
- Configuring a real deployment? See
  [Configuration](/docs/reference/configuration/) for every flag,
  environment variable, and default.
- Setting up storage? See [Set up a bucket](/docs/guides/bucket/).