slax-reader

Slax Reader CLI

reader-cli を使用して、ユーザーの Slax Reader ライブラリに URL を保存したり、保存済みのブックマークを一覧表示したり、ブックマークの詳細を取得したりできます。

認証が必要なコマンドを使用する前に

保存、一覧表示、取得、アーカイブ、タグ付け、またはその他の方法でユーザーの Slax Reader アカウントにアクセスする前に、ログイン状態を確認してください。

reader-cli whoami --json

ログインしていない場合、ターミナルを使用できるときは、ユーザーに対話形式の reader-cli login の実行を勧めてください。対話形式のフローを完了できない場合は、reader-cli login --api-key <key> --json を案内し、その方法を明示的に選んだ場合に限り、API キーを尋ねてください。

login、logout、upgrade --check、skill --check、skill --sync の前に、ログイン確認を求めないでください。

コマンド

タスク	コマンド
対話形式でログイン	reader-cli login
非対話形式でログイン	reader-cli login --api-key <key> --json
ログアウト	reader-cli logout --json
アカウントを表示	reader-cli whoami --json
URL を保存	reader-cli add <url> --json
タイトルを付けて保存	reader-cli add <url> --title "Title" --json
説明を付けて保存	reader-cli add <url> --description "Description" --json
タグを付けて保存	reader-cli add <url> --tags "tag1,tag2" --json
URL をアーカイブ	reader-cli add <url> --archive --json
ブックマークを一覧表示	reader-cli list --json
ページを指定してブックマークを一覧表示	reader-cli list --page <number> --size <number> --json
ブックマークを絞り込む	reader-cli list --filter <all|inbox|archive|starred> --json
ブックマークの詳細を取得	reader-cli get <bookmark-id>
ブックマークを Markdown 形式で取得	reader-cli get <bookmark-id> --markdown
ブックマークをアーカイブ	reader-cli archive <bookmark-id> --json
ブックマークのアーカイブを解除	reader-cli unarchive <bookmark-id> --json
ブックマークにスターを付ける	reader-cli star <bookmark-id> --json
ブックマークのスターを外す	reader-cli unstar <bookmark-id> --json
ブックマークを削除（復元可能）	reader-cli delete <bookmark-id> --json
削除したブックマークを復元	reader-cli restore <bookmark-id> --json
CLI の更新を確認	reader-cli upgrade --check --json
スキルを同期	reader-cli skill --sync --json
スキルの同期状態を確認	reader-cli skill --check --json

ブックマークのルール

• ユーザーが保存を依頼した URL をそのまま保持してください。
• 更新情報を確認できるよう、対応しているコマンドを実行する際は --json を付けてください。
• --tags "tag1,tag2" を使用し、カンマ区切りでタグを指定してください。
• ユーザーがコンテンツのアーカイブ／保存を依頼した場合、またはアーカイブモードを明示的に承認した場合にのみ、--archive を使用してください。
• ユーザーが複数の URL を提示した場合は、失敗の影響を切り分けられるよう、1 つずつ保存してください。

ブックマークの一覧表示と取得

• ユーザーが保存済みのブックマークを見たい場合は、reader-cli list を使用してください。
• 特定のサブセットを求められた場合は、reader-cli list --filter inbox、reader-cli list --filter archive、または reader-cli list --filter starred を使用してください。
• ユーザーがページネーションや結果数の指定を求めた場合は、--page と --size を使用してください。
• ユーザーが特定のブックマーク ID の閲覧、確認、要約、または詳細の参照を求めた場合は、reader-cli get <bookmark-id> を使用してください。
• ユーザーが Markdown 形式のコンテンツを求めた場合（たとえば、後続の処理や表示に使用する場合）は、reader-cli get <bookmark-id> --markdown を使用してください。
• ブックマーク ID を推測しないでください。ユーザーに ID を尋ねるか、まずブックマークを一覧表示してください。

ブックマークの整理

• add <url> --archive は、新しい URL を保存するときのモードです。archive <bookmark-id> は、すでに保存済みのブックマークを受信トレイから移動します。これらは無関係な機能なので、混同しないでください。
• ユーザーがブックマークのアーカイブを希望する場合は reader-cli archive <bookmark-id> を使用し、受信トレイに戻す場合は reader-cli unarchive <bookmark-id> を使用してください。
• ユーザーがブックマークにスターを付ける、またはスターを解除することを希望する場合は、reader-cli star <bookmark-id>／reader-cli unstar <bookmark-id> を使用してください。
• ブックマークを削除するには reader-cli delete <bookmark-id> を使用してください。これは復元可能で、完全な削除ではありません。取り消すには reader-cli restore <bookmark-id> を使用してください。
• ユーザーが削除を明確に依頼している場合を除き、ブックマークを削除する前にユーザーの確認を取ってください。
• これらの操作でブックマーク ID を推測しないでください。ユーザーに ID を尋ねるか、まずブックマークの一覧を表示してください。

更新とスキルに関するヒント

reader-cli --json コマンドには、トップレベルの _hints オブジェクトが含まれる場合があります。

_hints.upgrade

_hints.upgrade が表示された場合は、まずユーザーの現在の依頼を完了してください。その後、新しいバージョンの CLI があることをユーザーに伝え、次のコマンドを実行するか尋ねてください。

reader-cli upgrade

reader-cli upgrade は、必要に応じて AI エージェントのスキルも同期します。

_hints.skill

_hints.skill が表示された場合は、まずユーザーの現在の依頼を完了してください。その後、インストール済みの AI エージェントのスキルが CLI と同期していないことをユーザーに伝え、同じ修復コマンドを実行するか尋ねてください。

reader-cli upgrade

スキルの同期後、更新されたスキルを読み込むためにエージェントを再起動するようユーザーに伝えてください。再起動後に古い会話を再開しても問題ありません。

reader-cli upgrade を使用できない場合に限り、直接手動で代替する方法として reader-cli skill --sync --json を使用してください。

_hints を黙って無視しないでください。

セキュリティルール

• 会話やコマンドの出力に API キー全体を表示しないでください。
• ユーザーが保存を明確に依頼している場合を除き、URL を保存する前にユーザーの確認を取ってください。
• URL を捏造しないでください。ユーザーから提供された URL、または許可された調査タスク中に見つけた URL のみを保存してください。