# WriteForge

> WriteForge is a notes app: markdown notes, database tables, kanban boards and diagrams in nested folders, organized in workspaces, with an AI-first REST API that people and AI agents use with personal API tokens.

Paths are relative to the WriteForge site. The API lives under `/api`; send `Authorization: Bearer wfg_…` with a token created in Settings › API tokens.

Agents with a shell: use the `wf` command line, `npx -y @writeforge/cli` (npm package `@writeforge/cli`). `wf login --url <site>` keeps the token on the machine once; then `wf workspace`, `wf search`, `wf read`, `wf append`, `wf api <METHOD> <path>` and the rest print the API's JSON (`wf help` lists them).

## Docs

- [Agent skill (SKILL.md)](/api/skill): everything an AI agent needs to use WriteForge: where to find each resource, authentication, the document kinds, what to call for each task, the request and response formats, the workflows, the markdown dialect, the rules, the errors and every endpoint. Load it before using the API (also at `/skill` on the site).
- [Agent skill (zip)](/api/skill/download): the same skill as a folder, with `references/markdown.md` (the markdown dialect), `references/tables.md` (databases and boards), `references/diagrams.md` (the diagram format) and the contract, ready to install.
- [OpenAPI contract](/api/openapi.yaml): the source of truth for every operation, schema and error (76 operations; also as [JSON](/api/openapi.json)).
- [API reference](/docs/api): interactive reference for people.
- MCP server at `/api/mcp`: for agents that speak MCP (Claude Code, Codex, Claude Desktop): Streamable HTTP with the same `Authorization: Bearer wfg_…` token, and tools for the workspace tree, search, documents, tables, boards and diagrams.