{"id":45522743,"url":"https://github.com/latebit-io/demarkus","last_synced_at":"2026-06-14T01:06:24.235Z","repository":{"id":340570879,"uuid":"1158150476","full_name":"latebit-io/demarkus","owner":"latebit-io","description":"De-centralized - markdown - for us: an information web adjacent markdown protocol for knowledge sharing between humans and agents, humans to humans, agents to humans, and agents to agents","archived":false,"fork":false,"pushed_at":"2026-05-30T22:38:45.000Z","size":20295,"stargazers_count":13,"open_issues_count":4,"forks_count":1,"subscribers_count":1,"default_branch":"main","last_synced_at":"2026-05-30T23:18:49.508Z","etag":null,"topics":["agents","developer-tools","markdown","protocol","simple","soul","versioning"],"latest_commit_sha":null,"homepage":"http://www.demarkus.io/","language":"Go","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"other","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/latebit-io.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null,"notice":null,"maintainers":null,"copyright":null,"agents":null,"dco":null,"cla":null}},"created_at":"2026-02-14T21:56:56.000Z","updated_at":"2026-05-29T16:18:29.000Z","dependencies_parsed_at":"2026-03-28T22:03:10.491Z","dependency_job_id":"2a572554-0abe-441b-a3c5-464b1af2fca9","html_url":"https://github.com/latebit-io/demarkus","commit_stats":null,"previous_names":["latebit-io/demarkus"],"tags_count":159,"template":false,"template_full_name":null,"purl":"pkg:github/latebit-io/demarkus","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/latebit-io%2Fdemarkus","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/latebit-io%2Fdemarkus/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/latebit-io%2Fdemarkus/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/latebit-io%2Fdemarkus/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/latebit-io","download_url":"https://codeload.github.com/latebit-io/demarkus/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/latebit-io%2Fdemarkus/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":33716339,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-05-26T15:22:16.424Z","status":"online","status_checked_at":"2026-05-31T02:00:06.040Z","response_time":95,"last_error":null,"robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":true,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["agents","developer-tools","markdown","protocol","simple","soul","versioning"],"created_at":"2026-02-22T23:13:19.514Z","updated_at":"2026-06-14T01:06:24.220Z","avatar_url":"https://github.com/latebit-io.png","language":"Go","funding_links":[],"categories":["Protocol"],"sub_categories":["JSON to Markdown"],"readme":"# Demarkus\n\n**A protocol for agents and humans, optimized for information**\n\nDemarkus implements the Mark Protocol: versioned markdown served over QUIC. No rendering pipeline, no tracking, no central authority. Read and write with capability tokens. Every change is traceable. Lightweight and installable anywhere.\n\nRun a single personal server, or compose many into an organizational **knowledge system**: a broker-fronted universe of servers behind one HTTPS endpoint with single sign-on. Humans and agents share the same versioned memory.\n\n## Install\n\n```bash\n# macOS / Linux: server + client\ncurl -fsSL https://raw.githubusercontent.com/latebit-io/demarkus/main/install.sh | bash\n\n# Client only (CLI, TUI, MCP)\ncurl -fsSL https://raw.githubusercontent.com/latebit-io/demarkus/main/install.sh | bash -s -- --client-only\n```\n\nSee [full install docs](https://www.demarkus.io/install/) for platform-specific guides and other options.\n\n### See it in action\n\n![Client install demo](docs/images/demarkus-client.gif)\n\n## Quick Start\n\n```bash\n# Fetch a document from the live soul server\ndemarkus mark://soul.demarkus.io/index.md\n\n# Browse interactively with the TUI\ndemarkus-tui mark://soul.demarkus.io/index.md\n\n# Run your own local server\ndemarkus-server -root ./docs/site\n```\n\nFor more examples (tokens, publishing, editing), see [full usage guide](https://www.demarkus.io/).\n\n## What's Included\n\n| Binary | Purpose |\n|--------|---------|\n| `demarkus-server` | QUIC server with versioned document store, capability-based auth |\n| `demarkus-token` | Generate and manage write tokens |\n| `demarkus-publish` | Direct-to-store writer for read-only server installs (chroot/RO mode) |\n| `demarkus` | CLI tool for all protocol operations (fetch, publish, append, graph, etc.) |\n| `demarkus-tui` | Terminal browser: markdown rendering, link navigation, persistent graph |\n| `demarkus-mcp` | MCP server for LLM agents (protocol verbs + graph crawling, backlinks, indexing) |\n\n## Protocol at a Glance\n\n**Transport**: QUIC (UDP 6309) | **Scheme**: `mark://` | **Content**: Markdown + YAML frontmatter\n\nRequest:\n```\nFETCH /hello.md\n```\n\nResponse:\n```\n---\nstatus: ok\nversion: 3\nmodified: 2026-01-15T10:30:00Z\n---\n\n# Hello World\n```\n\n**Verbs**: `FETCH` · `LIST` · `VERSIONS` · `LOOKUP` · `PUBLISH` · `APPEND` · `ARCHIVE`\n\n## Use Cases\n\n**Agent Memory**: Run a server as persistent memory across agent sessions. The Demarkus project itself uses this pattern at `mark://soul.demarkus.io` for architecture notes, debugging lessons, and journal entries. Hit the ground running with the [Claude Code plugin](plugins/claude-code/) or install via [OpenClaw](https://www.demarkus.io/install/openclaw/).\n\n**Organizational Knowledge System**: Compose many servers (\"worlds\") into a broker-fronted universe reachable through one HTTPS endpoint with OIDC single sign-on. A whole team joins with a single command, `/knowledge-join` from the [Claude Code knowledge plugin](plugins/claude-code-knowledge/), and their agents share organizational memory over MCP, with no per-developer server or token setup. See the [knowledge system scenario](https://www.demarkus.io/scenarios/knowledge-system/).\n\n**Personal Knowledge Base**: Local server, versioned documents, TUI browser. Everything from first write.\n\n**Public Documentation**: Deploy on a VPS, share links, gate writes with tokens.\n\n**Demarkus Hubs**: Link to content on other servers, building a federated directory of knowledge. Hubs can link to hubs.\n\n## Ecosystem\n\n- [Caztor](https://github.com/kevinboone/caztor): cross-platform Java GUI browser with preliminary Demarkus support\n- [Obsidian plugin](https://github.com/latebit-io/obsidian-demarkus): publish and browse from Obsidian\n- [Claude Code memory plugin](plugins/claude-code/): zero-config local memory for Claude Code\n- [Claude Code knowledge plugin](plugins/claude-code-knowledge/): join an organizational knowledge system (broker-fronted, MCP OAuth)\n- [OpenClaw skill](https://clawhub.ai/ontehfritz/demarkus): ClawHub skill for OpenClaw agents (see [install guide](https://www.demarkus.io/install/openclaw/))\n\nSee [www.demarkus.io/ecosystem](https://www.demarkus.io/ecosystem/) for the full list.\n\n## Build from Source\n\n```bash\ngit clone https://github.com/latebit-io/demarkus.git\ncd demarkus\nmake all   # or: make server / make client\n```\n\nRequires Go 1.26+. Binaries land in `server/bin/`, `client/bin/`, and `tools/bin/`.\n\n## Documentation\n\n- [Website](https://www.demarkus.io/): install guides, scenarios, troubleshooting\n- [Protocol Specification](docs/SPEC.md): complete wire format\n- [Design Rationale](docs/DESIGN.md): why things are built the way they are\n\n## Core Principles\n\n1. **Optimized for Information**: Markdown is the common language: structured enough for agents, readable enough for humans\n2. **Privacy First**: No user tracking, minimal logging, anonymity by default\n3. **Security Minded**: Encryption mandatory, capability-based auth, secure by default\n4. **Simplicity**: Human-readable protocol, minimal complexity\n5. **Anti-Commercialization**: No ads, no tracking, no central authority\n6. **Federation**: Anyone can run a server, content can be mirrored freely\n\n## License\n\n- Implementation: AGPL-3.0-only ([LICENSE](LICENSE))\n- Protocol Specification: CC0-1.0 ([LICENSE-PROTOCOL](LICENSE-PROTOCOL))\n\n---\n\n*\"The web we want, not the web we got.\"*\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Flatebit-io%2Fdemarkus","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Flatebit-io%2Fdemarkus","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Flatebit-io%2Fdemarkus/lists"}