docs(scribe): true up plugin + MCP docs after calendar/entity removal
Milestone #194 plugin/docs slice. - plugin.json: "second brain" framing -> "system-of-record"; bump 0.1.11 -> 0.1.12 (any plugin/ change must bump the manifest, issue #1040) - plugin/README.md + using-scribe SKILL + scribe_static_context: drop events/typed-entities from the surface lists; "second brain" -> "system of record" in the SessionStart context Claude reads each session - docs/api-keys-and-mcp.md: drop the Typed-entities + Events MCP tool rows, add the Systems row - README.md: rewrite the stale front-matter (chat/RAG/calendar/weather/push described a pre-pivot product) to the current Claude-driven work store Deeper pre-pivot doc-rot in docs/features.md + docs/api-reference.md (chat/journal/weather/web-research) is tracked separately as an issue. Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com> Claude-Session: https://claude.ai/code/session_01BPtbSzA4JLMAKgFZ8VTg7Q
This commit is contained in:
@@ -1,10 +1,10 @@
|
|||||||
# Fabled Scribe
|
# Fabled Scribe
|
||||||
|
|
||||||
A self-hosted second brain and project management application with integrated LLM capabilities. Write, organise, and act on your notes and tasks with the help of a local AI assistant — all running on your own hardware.
|
A self-hosted work system-of-record for software projects, built to be driven by Claude Code. Notes, tasks, issues, projects, milestones, rules, and stored processes — reachable from Claude via a built-in MCP endpoint and a bundled Claude Code plugin, with a clean web UI for humans. No in-app LLM; Claude is the sole assistant.
|
||||||
|
|
||||||
## Features
|
## Features
|
||||||
|
|
||||||
Notes and tasks with a Markdown editor, sub-tasks, milestones, and kanban project workspaces. AI chat with streaming responses, RAG over your notes, and tool use (web search, calendar, weather). A daily briefing that digests your tasks, RSS feeds, and weather on a schedule. Knowledge graph, per-user/group sharing, PWA with push notifications, and an MCP server for external AI clients.
|
Notes and tasks with a Markdown editor, sub-tasks, milestones, issues, and kanban project workspaces. Stored processes, an engineering rulebook system, and semantic search with proactive knowledge-injection into Claude's context. A knowledge graph, per-user/group sharing, and a built-in MCP server (`/mcp`) plus a bundled Claude Code plugin so Claude can record and recall your work directly.
|
||||||
|
|
||||||
## Quick Start
|
## Quick Start
|
||||||
|
|
||||||
|
|||||||
@@ -86,8 +86,7 @@ table here. The tools are grouped by family:
|
|||||||
| Tasks | `create_task`, `update_task`, `add_task_log`, `start_planning` | Actionable work + plans |
|
| Tasks | `create_task`, `update_task`, `add_task_log`, `start_planning` | Actionable work + plans |
|
||||||
| Projects / Milestones | `enter_project`, `get_project`, `create_milestone`, … | Containers and outcomes |
|
| Projects / Milestones | `enter_project`, `get_project`, `create_milestone`, … | Containers and outcomes |
|
||||||
| Search / Recall | `search`, `get_recent`, `list_tags` | Semantic + structured recall |
|
| Search / Recall | `search`, `get_recent`, `list_tags` | Semantic + structured recall |
|
||||||
| Typed entities | `create_person`, `create_place`, `create_list`, … | Structured records |
|
| Systems | `create_system`, `list_systems`, `list_system_records` | Reusable per-project subsystems/areas |
|
||||||
| Events | `create_event`, `list_events`, `update_event`, … | Calendar |
|
|
||||||
| Rulebooks | `list_always_on_rules`, `list_rules`, `create_rule`, `create_project_rule`, `subscribe_project_to_rulebook`, … | Engineering/workflow rules |
|
| Rulebooks | `list_always_on_rules`, `list_rules`, `create_rule`, `create_project_rule`, `subscribe_project_to_rulebook`, … | Engineering/workflow rules |
|
||||||
| Processes | `list_processes`, `get_process`, `create_process` | Saved prompts/workflows |
|
| Processes | `list_processes`, `get_process`, `create_process` | Saved prompts/workflows |
|
||||||
| Trash | `list_trash`, `restore`, `purge_trash` | Recoverable deletes |
|
| Trash | `list_trash`, `restore`, `purge_trash` | Recoverable deletes |
|
||||||
|
|||||||
@@ -1,7 +1,7 @@
|
|||||||
{
|
{
|
||||||
"name": "scribe",
|
"name": "scribe",
|
||||||
"description": "Scribe second brain for Claude Code: MCP tools over your notes/tasks/projects/rules, a session-start push channel that surfaces your always-on rules + active-project context, process-skills (writing-plans, systematic-debugging, verification, brainstorming), and your saved Scribe Processes auto-surfaced as skills (/scribe:sync). Replaces superpowers + file-memory with one app-backed plugin.",
|
"description": "Scribe system-of-record for Claude Code: MCP tools over your notes/tasks/projects/rules, a session-start push channel that surfaces your always-on rules + active-project context, process-skills (writing-plans, systematic-debugging, verification, brainstorming), and your saved Scribe Processes auto-surfaced as skills (/scribe:sync). Replaces superpowers + file-memory with one app-backed plugin.",
|
||||||
"version": "0.1.11",
|
"version": "0.1.12",
|
||||||
"author": { "name": "Bryan Van Deusen" },
|
"author": { "name": "Bryan Van Deusen" },
|
||||||
"mcpServers": {
|
"mcpServers": {
|
||||||
"scribe": {
|
"scribe": {
|
||||||
|
|||||||
+2
-2
@@ -3,8 +3,8 @@
|
|||||||
Turns a self-hosted [Scribe](https://git.fabledsword.com/bvandeusen/FabledScribe)
|
Turns a self-hosted [Scribe](https://git.fabledsword.com/bvandeusen/FabledScribe)
|
||||||
instance into a first-class Claude Code extension:
|
instance into a first-class Claude Code extension:
|
||||||
|
|
||||||
- **MCP tools** over your notes, tasks, projects, milestones, events, typed
|
- **MCP tools** over your notes, tasks, projects, milestones, systems, and
|
||||||
entities, and rulebook (the `scribe` server).
|
rulebook (the `scribe` server).
|
||||||
- **Session-start push channel** — a `SessionStart` hook injects your always-on
|
- **Session-start push channel** — a `SessionStart` hook injects your always-on
|
||||||
rules + active-project context so Scribe surfaces *without being asked*.
|
rules + active-project context so Scribe surfaces *without being asked*.
|
||||||
- **Universal process-skills** — brainstorm, systematic-debugging, TDD,
|
- **Universal process-skills** — brainstorm, systematic-debugging, TDD,
|
||||||
|
|||||||
@@ -1,7 +1,7 @@
|
|||||||
# Scribe — your second brain and system of record
|
# Scribe — your system of record
|
||||||
|
|
||||||
This environment has the **Scribe** plugin: the operator's self-hosted second
|
This environment has the **Scribe** plugin: the operator's self-hosted system
|
||||||
brain (notes, tasks, projects, milestones, rules) reachable through the
|
of record (notes, tasks, projects, milestones, rules) reachable through the
|
||||||
`scribe` MCP tools. Treat Scribe — **not local files** — as the source of truth
|
`scribe` MCP tools. Treat Scribe — **not local files** — as the source of truth
|
||||||
for the operator's work, and as your own working memory across sessions.
|
for the operator's work, and as your own working memory across sessions.
|
||||||
|
|
||||||
|
|||||||
@@ -5,8 +5,8 @@ description: Use at the START of every session, and before answering anything ab
|
|||||||
|
|
||||||
# Using Scribe
|
# Using Scribe
|
||||||
|
|
||||||
Scribe is the operator's self-hosted second brain (notes, tasks, issues,
|
Scribe is the operator's self-hosted system of record (notes, tasks, issues,
|
||||||
projects, milestones, systems, events, typed entities) and rulebook, reachable
|
projects, milestones, systems) and rulebook, reachable
|
||||||
through the bundled `scribe` MCP server. Its value is mostly in what it
|
through the bundled `scribe` MCP server. Its value is mostly in what it
|
||||||
**already holds** — so make reading it a reflex, not something you wait to be
|
**already holds** — so make reading it a reflex, not something you wait to be
|
||||||
asked for.
|
asked for.
|
||||||
|
|||||||
Reference in New Issue
Block a user