EtherPK Client
The source of the EtherPK Client and Headless Client, available under the .
Power your agent
पब्लिशर की अपनी कमांड। PlugMCP एंडपॉइंट नहीं।
Host a copy with our keys and logs.
npx -y @appsoftwareltd/[email protected]Claude Code में लोकल कमांड के लिए इंस्टॉल लिंक नहीं है। नीचे दी गई कमांड कॉपी करें और टर्मिनल में चलाएँ।
claude mcp add appsoftwareltd-etherpk-mcp -- npx -y @appsoftwareltd/etherpk-mcp@0.30.0टर्मिनल में चलाएँ।
{ "mcpServers": { "appsoftwareltd-etherpk-mcp": { "command": "npx", "args": [ "-y", "@appsoftwareltd/[email protected]" ] } }}claude_desktop_config.json
रिमोट URL या आपकी मशीन पर कमांड? दोनों इंस्टॉल में क्या अंतर है
PlugMCP पर चलाएँ
A new server you create. It is not this listing's official endpoint. Use the publisher install when you want their URL and their credentials.
लॉन्चपब्लिशर से
The source of the EtherPK Client and Headless Client, available under the .
EtherPK Headless Client: an MCP server over a synced knowledge graph, run beside the agent on the user's own machine.
Try the demo from etherpk.com. It runs in your browser and needs no account (data remains in your browser).
Graph View
Document Editor (Prose and Outliner Blocks)
Task Kanban View
Aggregate Map View
EtherPK is a personal knowledge base in plain Markdown. Journal entries hold daily thinking, pages
hold what outlives a day, and [[wikilinks]] tie them into a knowledge graph. The Client is the
editor: a SvelteKit app that opens a graph from a folder on your computer, or from a Sync Server
that stores graphs end-to-end encrypted and cannot read them. The Headless Client is the same
engine without an editor: an MCP server that gives an AI agent one of your graphs.
User documentation is at https://docs.etherpk.com.
The Elastic License 2.0 lets you use, copy, modify and self-host this software. It does not let you offer it to others as a hosted or managed service. It is a source-available licence, not an open source one.
docker run --rm -p 3000:3000 ghcr.io/appsoftwareltd/etherpk-client:latest
Every tag is listed on the image's package page.
Open http://localhost:3000. With no settings the Client works with graph folders on your
computer and offers a Custom server form for connecting to a Sync Server by its address. The
settings it reads are listed, with their defaults, in
apps/client/.env.example - pass them with --env-file.
Each release attaches etherpk-client-<version>.tar.gz, which runs on Node.js 24 or later on
Windows, macOS and Linux, with nothing to install:
tar -xzf etherpk-client-<version>.tar.gz
cd etherpk-client
HOST=127.0.0.1 PORT=3000 node build
The full guide, including Windows commands, is Running EtherPK On Your Own Computer.
Published to npm as
@appsoftwareltd/etherpk-mcp.
npx @appsoftwareltd/etherpk-mcp --help
Setup for each kind of graph is in apps/mcp/README.md.
The etherpk skill teaches an AI agent (Claude Code, Codex, Cursor and the others the
skills CLI supports) to make a blog, docs site or wiki
folder in EtherPK's format inside any project, to write and edit its pages, to check it with a dry
run of the publish, and to publish it. For a synced graph it sends the agent to the Headless
Client's tools. Install it in the project the agent works in:
npx skills add appsoftwareltd/etherpk-client
Add -g to install it for every project. The skill is installed from this repository's main
branch, and npx skills add appsoftwareltd/etherpk-client#v<version> pins it to a release.
npx skills update brings it up to date.
You need Node.js 24 or later and pnpm - corepack enable provides the pnpm version that
package.json names.
pnpm install --frozen-lockfile
pnpm dev # the Client on http://localhost:5173
pnpm check # type check
pnpm lint
pnpm test # Vitest unit suites
pnpm build # the Client and the Headless Client
docker build -f apps/client/Dockerfile -t etherpk-client .
Copy apps/client/.env.example to apps/client/.env to change the development settings.
To develop an extension against the Client, build it and start the development server with its
folder named in ETHERPK_DEV_EXTENSIONS (several are separated by commas). It is loaded like an
extension the Client ships, and one with the same id replaces it:
ETHERPK_DEV_EXTENSIONS=/path/to/my-extension pnpm dev
main publishes images tagged edge and sha-<commit>. The image of a commit
that is not a release is deleted after 30 days, except the newest three, so pin a version tag.v<version> tag. It publishes images tagged <version>, <major>.<minor> and
latest, a GitHub Release with the Node bundle attached, and @appsoftwareltd/etherpk-mcp and
@appsoftwareltd/etherpk-extension-api at the same version on npm.This repository is a one-way copy of App Software's private EtherPK repository, exported on every
change there. Each commit here is one export - its GitOrigin-RevId trailer names the private
commit it came from. Code comments cite design records (ADR 0072) and glossary terms
([[Knowledge Graph]]) that live in the private repository and are not published here.
Issues are welcome. Pull requests are not merged here - CONTRIBUTING.md explains why and what happens instead. Report security issues as SECURITY.md describes.
EtherPK Headless Client: an MCP server over a synced knowledge graph, run beside the agent on the user's own machine.
{ "mcpServers": { "appsoftwareltd-etherpk-mcp": { "command": "npx", "args": [ "-y", "@appsoftwareltd/[email protected]" ] } }}टूल
अभी टूल सूची नहीं है। रिमोट सर्वर को पहले हेल्थ चेक के बाद सूची मिलती है।
FAQ
इस पेज पर Cursor, Claude Desktop, Claude Code या VS Code के लिए stdio कॉन्फ़िग कॉपी करें। यह पब्लिशर का इंस्टॉल इस्तेमाल करता है, PlugMCP प्रॉक्सी नहीं।
इस रिकॉर्ड में कोई ज़रूरी एनवायरनमेंट वेरिएबल दर्ज नहीं है।
@appsoftwareltd/etherpk stdio पर लोकल चलता है।
पिछली जाँच 2026-11-14 को हुई। EtherPK Headless Client: an MCP server over a synced knowledge graph, run beside the agent on the user's own machine.