Craft Docs のローカルファースト CLI:Craft Desktop のキャッシュから、対象の REST フォールバック、API のみの書き込み時に読み込みます。

単一バイナリBan CLI、AI-agent-first、macOSとLinux上で動作します。 また、RaycastとNodeスクリプト用のTypeScriptライブラリをエクスポートします。

非公式。 Craft Docs と提携していません。

**MacOSの[[craft source auto]をお読みください。 Unfiltered [docs ls と単純 docs search] は、Craft のローカルキャッシュを最初に使用し、REST に自動的にフォールバックします。 [--apiをルーチンに渡さないでください。 Markdown ドキュメントはキャッシュも読み込みます。 構造化された/raw 読み取り、タスク、リマインダー、コレクション、フィルタリングされたクエリ、全ての書き込みは REST を使用します。

お問い合わせ

インストール(あなたのAIエージェントにこれを貼り付ける)

Craft-cli をインストールするには、以下のブロックを AI コーディング エージェント (Claude Code、Codex、OpenCode、 Cursor など) に貼り付けます。 エージェントは、クローン、ビルド、インストール、認証、スキル登録を処理します。

お問い合わせ

人間のための

Craft Docs のローカルファースト CLI です。 第一次目標は、ローカルファイルとしてAIコーディングエージェント(クロードコード、Codex、OpenCodeなど)から読みやすく編集しやすいようにCraftコンテンツを作ることです.

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