artifacts
成果物を一覧表示し、読み取ります。
構文
artifactshare artifacts [COMMANDS] <OPTIONS>option
--help · --version · --json · --base-url · --token · --profile · --allow-plaintext-token-store · --insecure-localhost
Artifact Share CLI リファレンス
ターミナルから成果物を共有、更新、読み取り、整理するための公開リファレンスです。
導入と認証
Node.js 22.19 以降が必要です。npx --yes @artifactshare/cli init から始め、ブラウザの device login を完了します。CI では制限した token を profiles import-token で取り込み、アカウントを分けるときは --profile を使います。
構文
artifactshare [COMMANDS] <OPTIONS>option
--help · --version · --json · --base-url · --token · --profile · --allow-plaintext-token-store · --insecure-localhost
基本操作
ファイル、フォルダ、静的サイトは share、同じ URL の差し替えは update、読み取りは open または artifacts get、保存は download、レビューは comments、整理は projects、アカウントと設定は profiles と config、agent の準備は skills を使います。
コマンドリファレンス
以下の command surface は公開 CLI の help から生成されています。構文と受理する option も生成 snapshot から描画します。
公開 command 一覧
artifacts get
成果物とメタデータを読み取ります。
構文
artifactshare artifacts get <OPTIONS> <artifactIdOrUrl>option
--help · --version · --json · --base-url · --token · --profile · --allow-plaintext-token-store · --insecure-localhost · --offset · --include
artifacts list
project または home を含む、アクセスできる成果物を一覧表示します。
構文
artifactshare artifacts list <OPTIONS>option
--help · --version · --json · --base-url · --token · --profile · --allow-plaintext-token-store · --insecure-localhost · --project-id · --home · --query
changelog
CLI のリリースノートを表示します。
構文
artifactshare changelog <OPTIONS>option
--help · --version · --json
comments
成果物のコメントを扱います。
構文
artifactshare comments [COMMANDS] <OPTIONS>option
--help · --version · --json · --base-url · --token · --profile · --allow-plaintext-token-store · --insecure-localhost
comments delete
コメントメッセージを削除します。
構文
artifactshare comments delete <OPTIONS> <artifactIdOrUrl>option
--help · --version · --json · --base-url · --token · --profile · --allow-plaintext-token-store · --insecure-localhost · --thread-id · --message-id
comments edit
コメントメッセージを編集します。
構文
artifactshare comments edit <OPTIONS> <artifactIdOrUrl>option
--help · --version · --json · --base-url · --token · --profile · --allow-plaintext-token-store · --insecure-localhost · --message-id · --body
comments list
コメントのスレッドとメッセージを一覧表示します。
構文
artifactshare comments list <OPTIONS> <artifactIdOrUrl>option
--help · --version · --json · --base-url · --token · --profile · --allow-plaintext-token-store · --insecure-localhost
comments post
コメント、返信、引用コメントを投稿します。
構文
artifactshare comments post <OPTIONS> <artifactIdOrUrl>option
--help · --version · --json · --base-url · --token · --profile · --allow-plaintext-token-store · --insecure-localhost · --body · --reply-to · --quote · --quote-before · --quote-after · --agent
comments reopen
解決済みのコメントスレッドを再開します。
構文
artifactshare comments reopen <OPTIONS> <artifactIdOrUrl>option
--help · --version · --json · --base-url · --token · --profile · --allow-plaintext-token-store · --insecure-localhost · --thread-id
comments resolve
コメントスレッドを解決済みにします。
構文
artifactshare comments resolve <OPTIONS> <artifactIdOrUrl>option
--help · --version · --json · --base-url · --token · --profile · --allow-plaintext-token-store · --insecure-localhost · --thread-id
config
ローカル CLI 設定を確認、変更します。
構文
artifactshare config [COMMANDS] <OPTIONS>option
--help · --version · --json · --base-url · --token · --profile · --allow-plaintext-token-store · --insecure-localhost
config get
user、repository、effective のスコープで設定を読み取ります。
代表例
npx --yes @artifactshare/cli config get home_audience --scope effective --json構文
artifactshare config get <OPTIONS> [<key>]option
--help · --version · --json · --base-url · --token · --profile · --allow-plaintext-token-store · --insecure-localhost · --scope
config set
user または repository のスコープに設定を保存します。
代表例
npx --yes @artifactshare/cli config set home_audience private --scope user --json構文
artifactshare config set <OPTIONS> <key> <value>option
--help · --version · --json · --base-url · --token · --profile · --allow-plaintext-token-store · --insecure-localhost · --scope
config unset
スコープに保存した設定を削除します。
構文
artifactshare config unset <OPTIONS> <key>option
--help · --version · --json · --base-url · --token · --profile · --allow-plaintext-token-store · --insecure-localhost · --scope
delete
成果物を完全に削除します。
構文
artifactshare delete <OPTIONS> <artifactIdOrUrl>option
--help · --version · --json · --base-url · --token · --profile · --allow-plaintext-token-store · --insecure-localhost
doctor
認証、設定、接続状態を確認します。
構文
artifactshare doctor <OPTIONS>option
--help · --version · --json · --base-url · --token · --profile · --allow-plaintext-token-store · --insecure-localhost
download
成果物をローカルパスへダウンロードします。
構文
artifactshare download <OPTIONS> <artifactIdOrUrl>option
--help · --version · --json · --base-url · --token · --profile · --allow-plaintext-token-store · --insecure-localhost · --output · --force
edit
成果物のタイトル、visibility、共有先、投稿先を編集します。
構文
artifactshare edit <OPTIONS> <artifactIdOrUrl>option
--help · --version · --json · --base-url · --token · --profile · --allow-plaintext-token-store · --insecure-localhost · --title · --visibility · --grant-email · --revoke-email · --project-id · --home
init
agent を検出し、skill をインストールして初期設定を始めます。
代表例
npx --yes @artifactshare/cli init --json構文
artifactshare init <OPTIONS>option
--help · --version · --json · --base-url · --token · --profile · --allow-plaintext-token-store · --insecure-localhost · --project-id · --dry-run
login
ブラウザの device login で CLI を認証します。
代表例
npx --yes @artifactshare/cli login --json構文
artifactshare login <OPTIONS>option
--help · --version · --json · --base-url · --token · --profile · --allow-plaintext-token-store · --insecure-localhost
logout
保存済みのローカル認証情報を削除します。
構文
artifactshare logout <OPTIONS>option
--help · --version · --json · --base-url · --token · --profile · --allow-plaintext-token-store · --insecure-localhost
move
成果物を project または home へ移動します。
構文
artifactshare move <OPTIONS> <artifactIdOrUrl>option
--help · --version · --json · --base-url · --token · --profile · --allow-plaintext-token-store · --insecure-localhost · --project-id · --home
open
Artifact Share URL を読み取り、必要なら CLI skill を準備します。
代表例
npx --yes @artifactshare/cli open <artifact-id-or-url> --json構文
artifactshare open <OPTIONS> <artifactIdOrUrl>option
--help · --version · --json · --base-url · --token · --profile · --allow-plaintext-token-store · --insecure-localhost
profiles
名前付きの認証 profile を管理します。
構文
artifactshare profiles [COMMANDS] <OPTIONS>option
--help · --version · --json · --base-url · --token · --profile · --allow-plaintext-token-store · --insecure-localhost
profiles delete
名前付き profile を削除します。
構文
artifactshare profiles delete <OPTIONS>option
--help · --version · --json · --base-url · --token · --profile · --allow-plaintext-token-store · --insecure-localhost
profiles import-token
CI または手動発行 token を profile に取り込みます。
代表例
printf '%s' "$ARTIFACTSHARE_TOKEN" | npx --yes @artifactshare/cli profiles import-token --profile ci --json構文
artifactshare profiles import-token <OPTIONS>option
--help · --version · --json · --base-url · --profile · --allow-plaintext-token-store · --insecure-localhost
profiles list
保存済み profile を一覧表示します。
構文
artifactshare profiles list <OPTIONS>option
--help · --version · --json · --base-url · --token · --profile · --allow-plaintext-token-store · --insecure-localhost
profiles use
使用する active profile を選択します。
構文
artifactshare profiles use <OPTIONS> <name>option
--help · --version · --json · --base-url · --token · --profile · --allow-plaintext-token-store · --insecure-localhost
projects
project を管理します。
構文
artifactshare projects [COMMANDS] <OPTIONS>option
--help · --version · --json · --base-url · --token · --profile · --allow-plaintext-token-store · --insecure-localhost
projects create
project を作成します。
構文
artifactshare projects create <OPTIONS> <name>option
--help · --version · --json · --base-url · --token · --profile · --allow-plaintext-token-store · --insecure-localhost · --description · --visibility
projects edit
project の詳細、audience、アーカイブ状態を編集します。
構文
artifactshare projects edit <OPTIONS> <id>option
--help · --version · --json · --base-url · --token · --profile · --allow-plaintext-token-store · --insecure-localhost · --name · --description · --visibility · --add-email · --remove-email · --archive · --unarchive
projects list
利用できる project を一覧表示します。
構文
artifactshare projects list <OPTIONS>option
--help · --version · --json · --base-url · --token · --profile · --allow-plaintext-token-store · --insecure-localhost
request-access
workspace が投稿を制限しているときに upload access を申請します。
構文
artifactshare request-access <OPTIONS>option
--help · --version · --json · --base-url · --token · --profile · --allow-plaintext-token-store · --insecure-localhost · --note
resolve
URL、ID、その他の Artifact Share の値を解決します。
構文
artifactshare resolve <OPTIONS> <value>option
--help · --version · --json · --base-url · --token · --profile · --allow-plaintext-token-store · --insecure-localhost
share
ローカルのファイル、フォルダ、静的サイトを共有します。
代表例
npx --yes @artifactshare/cli share ./report.html --json構文
artifactshare share <OPTIONS> <path>option
--help · --version · --json · --base-url · --token · --profile · --allow-plaintext-token-store · --insecure-localhost · --project-id · --project · --home · --visibility · --grant-email · --key
skills
インストール済みの Artifact Share agent skill を管理します。
構文
artifactshare skills [COMMANDS] <OPTIONS>option
--help · --version · --json · --base-url · --token · --profile · --allow-plaintext-token-store · --insecure-localhost
skills ensure
検出した tool に skill があることを確認します。
構文
artifactshare skills ensure <OPTIONS>option
--help · --version · --json · --base-url · --token · --profile · --allow-plaintext-token-store · --insecure-localhost · --tool · --scope · --dry-run
skills install
選択した tool に skill をインストールします。
構文
artifactshare skills install <OPTIONS>option
--help · --version · --json · --base-url · --token · --profile · --allow-plaintext-token-store · --insecure-localhost · --tool · --scope · --dry-run · --force
skills list
skill がインストールされた tool を一覧表示します。
構文
artifactshare skills list <OPTIONS>option
--help · --version · --json · --base-url · --token · --profile · --allow-plaintext-token-store · --insecure-localhost
skills remove
tool からインストール済み skill を削除します。
構文
artifactshare skills remove <OPTIONS>option
--help · --version · --json · --base-url · --token · --profile · --allow-plaintext-token-store · --insecure-localhost · --tool · --scope · --dry-run
skills update
インストール済み skill を更新します。
構文
artifactshare skills update <OPTIONS>option
--help · --version · --json · --base-url · --token · --profile · --allow-plaintext-token-store · --insecure-localhost · --tool · --scope · --dry-run · --force
update
既存の共有 URL の背後に新しい版をアップロードします。
代表例
npx --yes @artifactshare/cli update <artifact-id-or-url> ./report.html --json構文
artifactshare update <OPTIONS> <artifactIdOrUrl> <path>option
--help · --version · --json · --base-url · --token · --profile · --allow-plaintext-token-store · --insecure-localhost
whoami
active account と workspace を表示します。
構文
artifactshare whoami <OPTIONS>option
--help · --version · --json · --base-url · --token · --profile · --allow-plaintext-token-store · --insecure-localhost
JSON と終了コード
--json、pipe、その他の非対話実行では、成功を schema_version: 2、ok: true、command、data の共通 envelope として stdout に出します。失敗は schema_version: 2、ok: false、command、error として stderr に出します。終了コード 0 は成功、1 は command の失敗、130 はキャンセルです。auth_required には verification URL と user code が含まれるので、承認後に同じ command を再実行します。
project、home、audience、設定
project への投稿はその project の audience に届きます。投稿先を指定しない share は home に投稿します。home_audience は目的別に使い分けます。個人の安全な既定値には user、一緒に使う全員が合意した方針には repository、一回限りの指定には明示 --visibility を使い、config get home_audience --scope effective --json で実効値を確認します。正本の設定は home_audience で、private は自分だけ、workspace は社内全員です。repository 設定は .artifactshare/config.json、user 設定は user config directory に保存します。home の解決順は repository の home_audience、repository の default_artifact_visibility、user の home_audience、user の default_artifact_visibility、製品既定 workspace です。default_artifact_visibility は互換 alias の補足に限ります。default_project_visibility は projects create 用の独立した既定値です。--grant-email は project の個別共有先を追加するだけで、project の visibility を暗黙に変更しません。
失敗と復旧
auth_required または token_invalid なら login か有効な profile token の import を行い、同じ command を再実行します。validation_failed は構文と option を確認します。target_not_found は URL または ID を解決し直します。upload_not_allowed は access を申請します。network_failed は base URL を確認して、投稿先を変えずに再試行します。