Локально-первый CLI для Craft Docs: быстрое чтение из кэша Craft Desktop при наличии права, резервный REST и записи только для API.

Однобинарный Bun CLI, AI-agent-first, работает на macOS и Linux. Также экспортирует библиотеку TypeScript для сценариев Raycast и Node.

Неофициальный. Не связан с Craft Docs.

**Агент читать политику: ** На macOS, сохранить craft source auto. Нефильтрованные docs ls и простые docs search сначала используют локальный кэш Craft и автоматически возвращаются в REST. Не переусердствуйте [3]. Документ Markdown читается также с помощью кэша. Структурированные/сырые чтения, задачи, напоминания, коллекции, фильтрованные запросы и каждая запись используют REST.

##Установка (вставьте это своему агенту)

Чтобы установить craft-cli, вставьте блок ниже в свой агент кодирования ИИ (Claude Code, Codex, OpenCode, Cursor и т. Д.). Агент будет обрабатывать клонирование, сборку, установку, аутентификацию и регистрацию навыков.

для людей

Первый CLI для Craft Docs. Основная цель состоит в том, чтобы сделать контент Craft таким же простым для чтения и редактирования от агентов кодирования ИИ (Claude Code, Codex, OpenCode и т. Д.), Как и локальные файлы в таких инструментах, как Obsidian.

craft-cli

Local-first CLI for Craft Docs: fast reads from Craft Desktop’s cache when eligible, REST fallback, and API-only writes.

Single-binary Bun CLI, AI-agent-first, runs on macOS and Linux. Also exports a TypeScript library for Raycast and Node scripts.

Unofficial. Not affiliated with Craft Docs.

Agent read policy: On macOS, keep craft source auto. Unfiltered docs ls and simple docs search use Craft’s local cache first and fall back to REST automatically. Do not pass --api routinely. Markdown document reads also use the cache. Structured/raw reads, tasks, reminders, collections, filtered queries, and every write use REST.

---

Install (paste this to your AI agent)

To install craft-cli, paste the block below into your AI coding agent (Claude Code, Codex, OpenCode, Cursor, etc.). The agent will handle clone, build, install, authentication, and skill registration.

You are installing craft-cli (https://github.com/pa1ar/craft-cli) for me. Use the latest public stable release and its matching bundled skill. Proceed end-to-end; ask only when a required choice or credential is missing.

1. RUNTIME CHECK
   Check whether `bun` is on PATH. If yes, continue.
   If not, use my stated package-manager preference, or install Bun from https://bun.sh. This project builds with Bun.

2. RELEASE + BUILD + INSTALL
   Resolve the latest public stable release:
   CRAFT_RELEASE_TAG="$(bun -e 'const r = await fetch("https://api.github.com/repos/pa1ar/craft-cli/releases/latest"); if (!r.ok) throw new Error("GitHub release lookup failed: " + r.status); const release = await r.json(); if (!release.tag_name || release.draft || release.prerelease) throw new Error("No stable release"); console.log(release.tag_name)')"
   Stop if that lookup fails. Do not silently install main or a local development binary.
   CRAFT_RELEASE_DIR="$HOME/.local/share/craft-cli/releases/$CRAFT_RELEASE_TAG"
   If the release directory already exists, preserve it. Verify its origin, tag commit and tracked source state before reuse; use a fresh directory if it has local edits.
   git clone --branch "$CRAFT_RELEASE_TAG" --depth 1 https://github.com/pa1ar/craft-cli.git "$CRAFT_RELEASE_DIR"
   cd "$CRAFT_RELEASE_DIR"
   Read this release's install.sh, then run ./install.sh.
   If install.sh fails, diagnose and report the failure before using its documented manual build/link equivalent. Keep the same release tag.
   Verify `~/.local/bin` is on PATH and `command -v craft` resolves to this release's binary. Add the PATH entry to my shell rc only if missing (detect zsh vs bash). Use `craft` from PATH for normal work.
   Record the release tag and `git rev-parse HEAD`; version alone does not prove a build came from a release.

3. CONNECTION