Files
pages-cli/README.md
T
Anya Tokugawa 336c5790e9 Refactor architecture into eight components and consolidate reliability work
Extract Grammaratur, Dregarnuhr, Geduldh, Mestionora, Ordoschnellic, Schutzaria, Kunstzeal and Seheweit behind compatible application contracts.

Include accumulated editor resilience, navigation and theme UX, remote CLI, storage/schema and DR groundwork, tests and design/operations documentation.

Verified: uncached full Go suite; go vet ./...; race tests for all eight components; 11 targeted Chromium tests; Node suites; 19 Python CLI tests; reproducible editor build. No push, release tag or deployment in this checkpoint.
2026-11-01 15:23:31 +09:00

4.8 KiB
Raw Blame History

pages-cli

pages — PagesWikiをターミナルから読む、たどる、編集する。

プロファイルや言語は初回に設定し、普段のコマンドは短く保ちます。 DBに直接アクセスする data/pageswiki-cli とは独立したHTTPクライアントです。

はじめる

Python 3.9以降、Linux/macOS等のUnix系環境を使用します。外部Pythonパッケージは不要です。 リポジトリ内では ./pages-cli/pages で実行できます。PATHへ配置する場合:

mkdir -p ~/.local/bin
install -m 755 pages-cli/pages ~/.local/bin/pages
# ~/.local/bin をPATHに含めてください。
pages configure --origin https://pages.example.test --username anya
pages login
pages

パスワードと必要なTOTPは非表示プロンプトへ入力します。pages 単独で対話シェル、 pages ls /manual のように続ければワンショット操作です。

pages[default]:/> cd /manual
pages[default]:/manual> ls
pages[default]:/manual> edit start
pages[default]:/manual> exit

exit はシェルを閉じるだけです。セッションを失効させる場合は pages logout。

設定する

pages configure                        # 設定を表示(トークンは表示しない)
pages configure --lang ja               # 現在の既定接続の編集言語
pages configure list                    # 接続先一覧、★が既定
pages configure set --profile work --origin https://work.example.test --username anya --lang en
pages configure use work                # 以後はworkを指定不要
pages status
pages edit /guide

既定プロファイル名は default、既定言語は und(言語未指定)です。OSや表示言語から 書き込み先の言語を推測しません。最初に名前付きプロファイルを作った場合はそれを既定とします。 言語は接続先ごとに保持し、編集時はその言語の既存Revisionを使用します。

一度だけ変更したいときは pages --profile personal --lang ja edit /guide も使えます。 プロファイル自体は先にconfigureで登録します。引数の上書きは設定ファイルを書き換えません。

設定ファイルは ~/.config/pages-cli/config.json(XDG_CONFIG_HOME対応)。

{
  "version": 1,
  "default_profile": "default",
  "profiles": {
    "default": {
      "origin": "https://pages.example.test",
      "username": "anya",
      "lang": "und"
    }
  }
}

セッションは別の sessions/PROFILE.json に保存します。設定にパスワードやBearerを入れないでください。 ディレクトリ0700/ファイル0600を要求します。セッション保持中のorigin・username変更には 事前logoutが必要です。同じプロファイルのシェルが開いている間の設定変更はロックで拒否します。 手編集で接続先を変えても、旧セッションを新接続先に送信しません。

旧試作名 data/pageswiki-remote は新コマンドへの案内用ランチャーです。 旧 ~/.config/pageswiki-remote/ の資格情報は自動移行・削除しません。 新しいconfigureで接続先を登録して再ログインし、不要な旧セッションはサーバのセッション管理で失効してください。

操作

コマンド 用途
ls / cd / pwd Semantic Pathをたどる。仮想フォルダにも移動可能
cat / view 正本の出力/$PAGERで閲覧
get ADDRESS LOCAL 正本をダウンロード。既存のローカルファイルは上書きしない
edit ADDRESS $EDITORで編集。Wikiはauthoring Markdown、他のテキストは原文
put LOCAL ADDRESS --base REVISION_UUID 明示した基点RevisionとのCASで更新
search QUERY 権限付きの検索候補
open ADDRESS ブラウザで閲覧。ブラウザ側ログインを使用
status / logout 接続状態表示/セッション失効

pages --help、pages configure --help、pages edit --help で引数を確認できます。 Tab補完、上下キーのプロセス内履歴に対応。複雑な引用位置の補完、Ctrl+Pのfuzzy UIは後続です。

初期版は既存Page・既存言語の更新まで。新規作成、OIDC引き継ぎ、バイナリ更新は未実装です。 競合や通信断で自動上書きせず、ローカル原稿を保持します。HTTPS必須(開発用loopbackのみHTTP可)。 詳しいURI・保存・安全性の契約は設計書を参照してください。

テスト

python3 pages-cli/test_pages.py
go test ./internal/server -run TestRemoteCLIHTTPIntegration -count=1

偽サーバと一時DBのみを使用します。本番資格情報や外部カレンダーは不要です。