使い方
- インストールコマンドをコピーし、自分の環境へ導入する前にソースを確認します。
- 必要なツール、認証情報、対応環境を原文で確認します。
- 入力と成果物を指定し、出力を資料と照合します。
npx skills add https://github.com/extrabrainapp/extrabrain-skills --skill use-extrabrain開始前の確認
- 導入にはモデル契約、API枠、ファイルへのアクセス許可は含まれません。
- スター数や導入数は活動の指標であり、独立した品質・安全性試験ではありません。
見出し、例、コード、表、リンク、参照画像を含む原文を表示しています。
Use ExtraBrain
Use the first-party extrabrain CLI for reference documents, pairing, capability discovery, and updates. Session preparation, recording controls, profiles, history, settings, and desktop app updates require the ExtraBrain app UI.
Establish the CLI contract
- Check
extrabrain --versionandextrabrain --helpfor the installed command surface.
If the command is missing, use the installation instructions in the ExtraBrain CLI repository.
- Before document operations, run
extrabrain --json capabilities. The JSON envelope is
{ "code": number, "data": object | null, "message": string }. On success, confirm data.apiVersion is v1, data.available is true, and data.capabilities advertises the required operation. Read references/documents.md for the mapping, commands, pairing scopes, and recovery steps.
- ExtraBrain must already be running with local document automation enabled. Discovery is
public and does not prove the CLI is paired. If a document command reports an authentication or scope error, pair with the scopes needed for the user's task and have the user approve the connection in the app. Credentials are stored by the CLI in macOS Keychain.
Use --json for command results. The exit code and per-file statuses determine success; a partial import is not a completed import.
Work with documents
- List existing documents before creating another copy. Use returned document IDs, revisions,
and index generations for later operations.
- Import local files directly through the CLI. It must run in the same filesystem namespace
as the selected files; a remote shell or container cannot use a desktop-only path.
- Search for relevant snippets before requesting extracted text. Read bounded text pages only
when needed. Use original export when the user needs the exact source bytes.
- After an import, check its per-file results and batch/item status, then verify document
metadata and indexing status. After deletion, verify the document is absent from the list.
- Delete only with explicit user intent, one known document ID, and its current revision.
On a revision conflict, reread metadata and confirm the changed target before retrying.
- Let the CLI manage import and deletion retry identifiers. Resume only with the returned
resume ID for the same unchanged source files and import intent.
Keep external research and source gathering in your own authorized tools. Do not access ExtraBrain's database or managed source directory, extract credentials, or build a separate document extractor to bypass the CLI.
If the CLI or app API is unavailable, explain the reported limitation. For file imports, the user can use Settings > Personalization > Reference Documents and the native file picker.
Update the CLI
When the user asks to update the CLI, run extrabrain update, then check extrabrain --version. This updates the standalone command. Use the app UI for desktop application updates.
