HN 日本語サマリー

← 一覧へ戻る
プログラミング

Show HN: Earth Game – 人生の目標をクエストに変えるオフラインCLIツール

Show HN: Earth Game – An offline CLI for turning life goals into quests (github.com)

31 pointsby modinfo8 コメント

要約

Earth Gameは、人生の目標をクエストとして管理し、次の行動を決定し、未完了のタスクを整理するためのプライベートでオフラインのCLIツールです。Pythonの標準ライブラリとSQLiteのみを使用し、依存関係や外部通信はありません。CLIだけでなく、ローカル限定のWeb UIとしても利用可能です。

全文翻訳

Earth Game

[画像: Earth Game: a connected planet with a glowing quest path]

[画像: Python 3.8+] [画像: Dependencies: standard library] [画像: Storage: local SQLite] [画像: Network: no external requests]

プライベートでオフラインなコンパニオン。クエストの選択、次のアクションの実行、未完了のループの解消、そして逸脱が始まる前の方向性の確認をサポートします。

Earth GameはPythonの標準ライブラリとSQLiteを使用しています。サードパーティの依存関係、アカウント、外部へのリクエスト、スコアリング、AI生成のアドバイスは一切ありません。

要件

  • Python 3.8以降
  • Unixライクなターミナル

Arch Linuxへのインストール

Earth GameはAURから利用可能です。

yay -S earth-game

インストール後、どこからでも earth または earth-game を実行してください。

クイックスタート

./earth init
./earth character edit
./earth quest add
./earth quest list
./earth quest start 1
./earth today

ブラウザを使いたいですか?同じアプリをローカル専用のWeb UIとして起動できます。

./earth web

これは http://127.0.0.1:8765/ でプライベートセッションURLを開き、CLIと同じデータベースを使用します。Ctrl-Cで停止します。LANにバインドしたり、外部リクエストを行ったりすることはありません。

コマンドは不足しているテキストをプロンプトで尋ねます。オプションは非対話的な使用もサポートしています。

./earth quest add \
  --title "Reconnect with an old friend" \
  --next "Send Sam a message" \
  --pillar connection \
  --driver purpose

./earth quest start 1
./earth today

完全なインターフェースについては ./earth --help または ./earth COMMAND --help を実行してください。完全な実用例については USAGE.md を参照してください。

コマンド

  • earth init: 既存のデータベースを上書きせずにローカルストレージを作成します。
  • earth character show|edit: 値、強み、摩擦、目的、反ビジョンを管理します。
  • earth quest add|list|start|done|drop: クエストを管理します。現在のクエストは1つだけです。
  • earth loop add|list|close: 未解決のタスクや懸念事項をキャプチャし、クローズします。
  • earth today: 現在のクエスト、次のアクション、未完了ループの数、レビュー状況を表示します。
  • earth review: 5つの短いリフレクションを記録します。--update-quest を渡すと、--next の回答を現在のクエストの次のアクションとして使用できます。
  • earth export [PATH]: すべてのデータを読みやすいJSONとしてエクスポートします。既存のファイルは上書きされません。
  • earth web: ローカルブラウザUIを起動します。--no-open を使用するか、--port PORT でポートを選択してください。

通常のループ

./earth loop add --text "Book the dentist"
./earth today
./earth quest done 1
./earth review
./earth export earth-export.json

データとプライバシー

デフォルトのデータベースパスは次のとおりです。

${XDG_DATA_HOME:-$HOME/.local/share}/earth-game/earth.db

別のパスを使用するには EARTH_GAME_DB を設定してください。

EARTH_GAME_DB=/path/to/earth.db ./earth init

データベースとJSONエクスポートは、Unixではプライベートパーミッションで作成されます。Earth Gameは外部ネットワークリクエストを行いません。Webコマンドはローカルループバックアドレスのみをリッスンし、起動時に表示されるプライベートセッションURLが必要です。

バックアップまたは復元するには、Earth Gameコマンドが実行されていない間にSQLiteデータベースをコピーしてください。./earth --help は、アクティブなデータパスを正確に表示します。

テスト

python3 -m unittest -v
python3 -m py_compile earth earth_core.py earth_web.py

構造

  • earth: CLI解析とターミナルインタラクションを含みます。
  • earth_core.py: SQLiteと共有ドメイン操作を含みます。
  • earth_web.py: ローカルHTTPサーバーとHTMLインターフェースを含みます。

製品の決定と将来の変更ルールについては、ROADMAP.md を参照してください。