anywrite
Compiled CLI covering all 52 endpoints of the Anytype local API — objects, properties, tags, search, chat, files — one binary, no MCP server needed.
- License 许可
- MIT
- 最近更新
- 2026-08-07
- Stars
- ★ 1
- Forks
- 0
01 前言 Front Matter
- name
- anywrite
- risk
- critical
- tags
- [ "anytype", "cli", "pkm", "notes", "api-integration", "productivity", "knowledge-management" ]
- tools
- [ "claude", "cursor", "gemini", "codex" ]
- author
- Antheurus
- plugin
- { "setup": { "docs": "SKILL.md", "type": "manual", "summary": "Requires a separately installed, user-approved anywrite executable at an explicit absolute path." }, "targets": { "codex": "blocked", "claude": "blocked" } }
- source
- community
- license
- MIT
- category
- productivity
- date_added
- 2026-07-15
- description
- Compiled CLI covering all 52 endpoints of the Anytype local API — objects, properties, tags, search, chat, files — one binary, no MCP server needed.
- source_repo
- Antheurus/anywrite
- source_type
- community
- license_source
- https://github.com/Antheurus/anywrite/blob/main/LICENSE
03 SKILL.md 正文
anywrite
Overview
anywrite is a single compiled Bun/TypeScript CLI for the Anytype desktop app's local HTTP API — all 52 endpoints across spaces, objects, properties, tags, types, templates, lists, chat, files, members, search, and auth — as one binary with zero runtime dependencies. It exists as a low-context alternative to Anytype's official MCP server: rather than exposing 52 always-loaded tools to every agent session, anywrite is a normal CLI wired as a skill that costs zero context until it's actually invoked, and is equally usable from a terminal or any script.
When to Use This Skill
- Use when the user mentions Anytype or asks to create, update, search, or organize notes, tasks, or PKM objects.
- Use when working with Anytype spaces, properties, tags, types, templates, or lists (sets and collections).
- Use when the user asks to upload files to a space, chat inside a space, or read/write structured objects programmatically.
How It Works
Step 1: Ensure Anytype desktop is running and authenticated
This repository does not ship the anywrite executable. The user must install or build a reviewed upstream release outside the current workspace and provide its explicit absolute path. Before use, verify that path is an executable regular file, is not a symlink, and is not a workspace-relative dist/ artifact. Never auto-discover or execute ./dist/anywrite from the repository being worked on.
The Anytype desktop app must be running locally (default http://localhost:31009). Authenticate once:
"/absolute/path/to/anywrite" auth --status # shows configured yes/no and where the key came from
"/absolute/path/to/anywrite" auth # challenge flow — a 4-digit code appears in the app
"/absolute/path/to/anywrite" auth --code 1234 # non-interactive form of the same exchange
The key is written to ~/.anywrite/config.json and is never printed by any command.
Step 2: Invoke a resource + action
anywrite <resource> <action> [positionals] [--flag value]
Resources: spaces, objects, properties, tags, types, templates, lists, files, members, search, chat, auth. Output is JSON by default; add --pretty for a human view, --json as an escape hatch for anything the typed flags don't model yet. space/type/property positionals accept a name or an id — names are resolved to ids automatically.
Examples
Example 1: Create and update an object
"/absolute/path/to/anywrite" objects create <space> --type task --name "Buy milk"
"/absolute/path/to/anywrite" objects update <space> <object_id> --status "Done"
Example 2: Search and upload a file
"/absolute/path/to/anywrite" search global --query "task" --types task
"/absolute/path/to/anywrite" files upload <space> --file ./image.png
Example 3: Read chat messages
"/absolute/path/to/anywrite" chat messages <space> <chat_id> --all
Best Practices
- ✅ Pass names for
space/type/propertyand let the CLI resolve them to ids. - ✅ Use default JSON output for scripting and
--prettyfor human review. - ✅ Reach for
--jsonwhen a brand-new API field isn't yet covered by a typed flag. - ❌ Don't set an empty-string emoji
--icon; omit the flag entirely instead. - ❌ Don't expect
lists add/removeto work on sets — they only apply to collections.
Limitations
- This skill does not replace environment-specific validation, testing, or expert review.
- Stop and ask for clarification if required inputs, permissions, or safety boundaries are missing.
- Bounded by the Anytype local API itself: no block-level editing (body is whole-markdown replace only), no member invite/role management, no template create/update/delete, no space deletion.
- The object body field is named
--bodyon create but--markdownon update.
Security & Safety Notes
- The API key is stored locally in
~/.anywrite/config.jsonand is never printed by any command, includingauth --status. - Config precedence at runtime:
ANYTYPE_API_KEYenv var, then~/.anywrite/config.json, then a read-only fallback to an existing~/.anytype-cli/config.yaml. - All operations target a locally-running Anytype desktop instance; no data is sent to third-party servers.
- Delete is a soft archive everywhere and is idempotent — a repeated delete stays
200, never410.
Common Pitfalls
- Problem:
lists add/removesilently does nothing on a set. Solution: These only work on collections, not sets. - Problem: Re-uploading an identical file returns an existing object id instead of a new one. Solution: This is intentional — file upload dedupes by content hash.
- Problem: Chat messages don't paginate like everything else. Solution: Chat paginates by cursor; every other resource paginates by offset.
Related Skills
@docx- When the deliverable is a Word document rather than an Anytype object.
04 同仓库更多 Skills
vercel-react-best-practices
React and Next.js performance optimization guidelines from Vercel Engineering. This skill should be used when writing, reviewing, or refactoring React/Next.js code to ensure optimal performance patterns. Triggers on tasks involving React components, Next.js pages, data fetching, bundle optimization, or performance improvements.
stop-slop
Remove AI writing patterns from prose. Use when drafting, editing, or reviewing text to eliminate predictable AI tells and produce more human-like writing.
ogilvy-copywriting
Apply David Ogilvy's advertising principles when writing or reviewing copy, headlines, product descriptions, landing pages, ads, emails, or any persuasive text. Use when the goal is copy that sells, not copy that wins awards. Covers positioning, headlines, promises, brand voice, long-form copy, and visual logic. Source: How to Create Advertising That Sells (1972) + Ogilvy on Advertising.
frontend-design
Create distinctive, production-grade frontend interfaces with high design quality. Use this skill when the user asks to build web components, pages, artifacts, posters, or applications (examples include websites, landing pages, dashboards, React components, HTML/CSS layouts, or when styling/beautifying any web UI). Generates creative, polished code and UI design that avoids generic AI aesthetics.
webapp-testing
Toolkit for interacting with and testing local web applications using Playwright. Supports verifying frontend functionality, debugging UI behavior, capturing browser screenshots, and viewing browser logs.
web-artifacts-builder
Suite of tools for creating elaborate, multi-component claude.ai HTML artifacts using modern frontend web technologies (React, Tailwind CSS, shadcn/ui). Use for complex artifacts requiring state management, routing, or shadcn/ui components - not for simple single-file HTML/JSX artifacts.