navig

NAVIG

No Admin Visible In Graveyard
問題はターミナルではありませんでした。その周りの混乱が問題でした。

メモ

NAVIG 3.x は安定版リリースです。 CLI の仕様（navig <resource> <action>）は安定しており、 変更にはセマンティックバージョニングが適用されます。メジャーバージョンをまたいでアップグレードする前に、CHANGELOGを確認してください。 ライブインフラストラクチャを操作する他のツールと同様に、本番環境の重要なシステムでは、まず読み取り専用の調査とドライランを使用してください。

---

動作を見る

ラボホスト上で実行したセッションを、tools/showcase/ の記録からそのままご覧いただけます。 出力への入力の追加や、内容の編集は一切ありません。全11シーン、動画、制作方法については docs/showcase をご覧ください。動画（90秒の予告編を含む）はNAVIG 3.25.0 リリースで公開しています。

ライブダッシュボード — navig dashboard	ホストと安全性 — host test、2つ目のセッションは拒否され、破壊的なコマンドは実行を見送られます
スペース — space init --dry-run → space init → space doctor	ブロック — block show → 手順ごとのリスクを表示する apply --dry-run
台帳と取り消し — ledger show → ledger verify → undo --list	自分のノード — navig whoami

---

前提条件

NAVIG CLI は、Powerline スタイルのステータスバーやアイコンに Nerd Font のグリフを使用します。マシンごとに一度インストールしてください。

pwsh navig/builtin/scripts/Install-NerdFont.ps1

プラットフォーム	推奨ターミナル	追加手順
Windows	Windows Terminal	スクリプトが自動でパッチを適用します
macOS	iTerm2 または Kitty	スクリプトの実行後、フォントを JetBrainsMono Nerd Font Mono に設定します
Linux	Kitty、Alacritty、GNOME Terminal	スクリプトの実行後、フォントを手動で設定します

すべてのプラットフォームで VS Code に自動でパッチが適用されます。スクリプトの実行後、VS Code とターミナルを再起動してください。

オフラインインストール：$env:NAVIG_FONT_ZIP にローカルの zip パスを設定するか、-LocalZip <path> を渡してください。

---

NAVIG とは？

NAVIG は、システムを稼働させるためだけに SSH セッションを切り替え、散在するスクリプトや分断されたダッシュボードを使い、場当たり的な認証情報を管理することに疲れた人のための、ターミナルファーストのインフラストラクチャ CLI およびランタイムです。

NAVIG は、プラットフォームチームの支援を受けられないまま、増え続けるリモートマシン、プロジェクト、運用上の負担を一人で管理していた創業者によって開発されました。問題はターミナルではありませんでした。問題はその周囲にある、分断されたすべてのものでした。SSH はあちこちにあり、SFTP は別の場所、データベースはダッシュボードの奥にあり、シークレットはメモに貼り付けられ、ログはプロバイダーごとに散らばり、一貫した操作画面がありませんでした。

NAVIG は、そんな状況を受け入れないという決意から生まれました。

NAVIG を使うと、リモートホスト、データベース、コンテナ、ファイル、トンネル、ワークフローを一か所から、構造と記憶機能を備えて直接操作できます。オプションの AI アシスタンスは、実際に役立つときまで邪魔になりません。

オペレーターのための、オペレーター向けの操作画面。

---

NAVIG Core（無料）と NAVIG Deck（有料）

NAVIG は、意図的に役割を分けた 2 つのレイヤーで提供されます。

• NAVIG Core（このリポジトリ）— Apache-2.0 のオープンソースです。デーモン、CLI、 エージェントランタイム、ボルト、スケジューラー、メッシュ、MCP サーバー、Telegram テキストボット、 ゲートウェイが含まれます。永久に無料で、CLI によるホスト数の制限はなく、テレメトリーもありません。
• NAVIG Deck — 洗練された UI コックピット（プロプライエタリ。pip install navig[deck] でインストールする署名済み PyPI wheel）。ホストインベントリー、メッシュトポロジー、ボルト UI、ミッションキュー、ワークフローランナー、Telegram Mini App が含まれます。1 台のホストでは無料です。Harbor Pass / Max では、ホスト規模の拡大と オペレーターモジュール一式が利用できます。詳しくは navig.run/deck をご覧ください。

この分割は明確です。デーモンはオープンで監査可能、Deck は 1 台のホストで無料です。Harbor サブスクリプションでは、ホスト規模、すべてのオペレーターモジュール、および Harbor Bay 全体が追加されます。プランについては navig.run/buy をご覧ください。

何があっても永久に無料のもの：

• CLI 全体 — navig ssh は無制限、接続するホスト数も無制限
• Telegram テキストボット（/start、/run、/status、すべてのコマンド）
• エージェントランタイム（navig ask、会話メモリー、ミッション）
• VS Code MCP 統合
• ボルト、スケジューラー、メッシュのピア検出
• メジャーバージョンを含むすべてのアップデート

Harbor サブスクリプションで利用できるのは、拡張性とオペレータースイートです。 デーモンが有料になることはありません。

---

NAVIG を選ぶ理由

ほとんどのオペレーターはすでに SSH を使っています。しかし、SSH の周辺にあるべきものは、まだ揃っていません。

おそらく使っているもの	NAVIG が追加するもの
SSH クライアント	1 つのアクティブなコンテキストでのマルチホスト管理
場当たり的なシェルスクリプト	ドライランとプレビューに対応した名前付きワークフロー
.env ファイル内のシークレット	コンテキストを考慮した解決機能を備えた暗号化ボルト
ログファイルでの grep	ホストを横断した構造化ログの追跡
Stack Overflow からのコピー＆ペースト	インフラをコンテキストとして扱う AI オペレーターレイヤー
マシンごとに 1 つのターミナル	メッシュネットワーキングとコマンド委任

NAVIG は構成管理ツールではありません（Ansible ではありません）。デプロイプラットフォームでもありません（Kubernetes ではありません）。これは人間のためのコントロールプレーンです。今すぐ実機に何かを行う必要があるとき、プレイブックを書かずに手を伸ばすものです。

---

機能

機能	説明
複数ホストの管理	SSH 経由でリモートホストを追加、切り替え、テスト、操作できます
リモート実行	コマンドを実行し、stdin をパイプで渡し、複雑なスクリプトには base64 エンコードを使用できます
データベース操作	MySQL、MariaDB、PostgreSQL のクエリ、ダンプ、復元、メンテナンスができます
ファイル操作	リモートファイルを安全にアップロード、ダウンロード、読み取り、編集、一覧表示できます
Docker とコンテナ	コンテナの確認、サービスの再起動、ログの追跡、Compose スタックの管理ができます
Web サーバーの制御	nginx/apache の設定を管理し、変更をテストして安全に再読み込みできます
暗号化された保管庫	認証情報を、平文の設定ファイルに秘密情報を残さずに保存できます
ワークフロー	ドライランとプレビューに対応した、繰り返し実行可能な複数ステップのフローを定義できます
AI オペレーターレイヤー	インフラタスクを自然言語で支援します — CLI、Telegram、または MCP
メッシュネットワーキング	LAN 上のピアツーピアによるノード検出とコマンド委任ができます
MCP 統合	AI エディターや互換性のあるクライアントにツールとリソースを公開します
デーモンとゲートウェイ	Telegram および Matrix チャネルに対応したバックグラウンドサービスです
Telegram Manager	Telegram アカウント全体を管理するツール（MTProto）：検索、移動、転送、重複排除に加え、ビジネス会話向け AI キャッチャー、返信キーワードアクション、削除アラート、リッチメッセージ返信に対応 — オーナー専用（ドキュメント · チートシート）
GitHub ミラーリング	navig github — GitHub リポジトリを検索、バックアップ、クローンします（フラットまたはネスト形式）。トークンは保管庫から取得します
TikTok	navig tiktok — 動画のダウンロード、メタデータと上位コメントの抽出、あらゆるリンクの AI 要約ができます（yt-dlp 経由）

---

インストール

Linux / macOS / WSL

curl -fsSL https://navig.run/install.sh | bash

Windows（PowerShell）

iwr -useb https://navig.run/install.ps1 | iex

pipx

pipx install navig

pip

pip install navig

インストールオプション

オプション	例	説明
--version	bash -s -- --version <release>	特定のバージョンを指定します
--dev	bash -s -- --dev	開発用の追加パッケージを含めます
--method git	bash -s -- --method git	PyPI ではなくソースからインストールします
NAVIG_EXTRAS	NAVIG_EXTRAS=voice,keyring	オプションの追加機能を有効にします
NAVIG_INSTALL_PROFILE	NAVIG_INSTALL_PROFILE=operator	初回実行時のブートストラッププロファイルを選択します

インストール後は、インストーラーパイプラインから Telegram のブートストラップを利用できます。

NAVIG_TELEGRAM_BOT_TOKEN="<your-bot-token>" navig init --profile operator

開発用インストール

git clone https://github.com/navig-run/core.git navig
cd navig
pip install -e ".[dev]"

仮想環境を使用する場合（任意ですが推奨）：

git clone https://github.com/navig-run/core.git navig
cd navig
python -m venv .venv
source .venv/bin/activate   # Windows: .venv\Scripts\activate
pip install -e ".[dev]"

確認

navig --version
navig --help

---

サーバーがない場合はこちら（ローカルモード）

まだ利用可能なリモートサーバーがなくても、NAVIG は localhost で動作します。

# Install
pip install navig

# Discover your local machine as a host
navig host discover-local

# Run your first command (on this machine)
navig run "echo hello from NAVIG && uname -a"

# Explore files
navig file list ~ --tree --depth 2

# Ask the AI operator layer something
navig ask "what process is using the most CPU right now?"

これで初回実行は完了です — リモートサーバーは必要ありません。

---

クイックスタート

# 1. Initialize — creates ~/.navig/, runs setup wizard
navig init

# 2. Add a remote host
navig host add

# 3. Test the connection
navig host test

# 4. Set it as active
navig host use <name>

# 5. Run your first remote command
navig run "uname -a"

# 6. Ask the AI operator layer something about it
navig ask "what is consuming the most memory on this host?"

これだけです。以降の機能はすべて、ここから構築できます。

まだサーバーがない場合は、examples/quickdemo.sh を使うと、60 秒でご自身のマシン上に同じ環境を構築できます。

次のステップ — 初回の navig run の後に実行するコマンド：

コマンド	内容
navig host add	ホストを追加します
navig vault set KEY=value	秘密情報を暗号化して保存します
navig db query "SELECT 1"	リモートデータベースに接続します
navig tunnel 5432	ポートへの SSH トンネルを開きます
navig flow run deploy.yaml	複数ステップのワークフローを実行します
navig ask "..."	AI オペレーターレイヤーに何でも質問できます

---

コマンドリファレンス

すべてのリソースで、一貫したパターンを使用します。

navig <resource> <action> [options]

インフラストラクチャ

コマンド	内容
navig host	リモートホストを追加、切り替え、テスト、確認します
navig run	リモートまたはローカルのホストでコマンドを実行します
navig file	リモートファイルをアップロード、ダウンロード、読み取り、編集します
navig db	データベースのクエリ、ダンプ、復元、メンテナンスを行います
navig docker	コンテナと Compose を操作します
navig web	Web サーバーの設定、テスト、再読み込みを行います
navig tunnel	SSH トンネルを管理します
navig backup	設定とデータのバックアップ／復元を行います

AI と自動化

コマンド	機能
navig ask	AI を活用したトラブルシューティングとコマンドの案内
navig flow	複数ステップの自動化ワークフロー
navig mcp	AI エディターやツールとの連携用 MCP サーバー
navig gateway	チャットゲートウェイ（Telegram、Matrix）の起動と管理
navig agent	自律型エージェントのランタイム — インストール、起動、設定、管理
navig telegram	Telegram マネージャー — ログイン、検索、整理、ビジネスキャッチャー、絵文字の権限
navig github	GitHub リポジトリの検索／バックアップ／クローン（デフォルトではフラット形式）— トークンは vault から取得
navig tiktok	TikTok コンテンツのダウンロードと AI による要約（説明と上位のコメント）

組織管理

コマンド	機能
navig config	設定の表示、検証、管理
navig vault	暗号化された認証情報の保存
navig space	複数コンテキストのオペレーター環境
navig mesh	LAN 内のピア検出とコマンドの委任

詳しい使い方については、navig help または navig help <topic> を実行してください。すべてのコマンドで --help も使用できます。

---

プラグイン

ファーストパーティプラグインは navig に新しいコマンドを追加します。また、いくつかのプラグインは navig をインストールしなくても単独で実行できます。ソースとプラグインごとのドキュメントはこちらです：navig-run/plugins。

プラグイン	機能	単独で実行	インストール
navig-agentctl	エージェントコントロールセンター（DevOps セクション）：セッション、ワークツリー、タスク、Agent Monitor（実行、フック、検証済みのランディング）…	— navig agentctl を追加	pip install "navig[agentctl]"
navig-ahk	navig 向け AutoHotkey v2 自動化 — クリック、入力、起動、ウィンドウ操作、AI が作成したスクリプトを、独立したプラグインとして提供	— Deck のインターフェイス	pip install "navig[ahk]"
navig-alexa	Alexa カスタムスキルサーバー — 音声で NAVIG を操作する公式スキルをホストし、リクエストの検証などを行います…	✅ navig-alexa	ソースから（まだ PyPI では公開されていません）
navig-alice	NAVIG 向け Yandex Dialog（навык Алисы）Webhook に加え、api.iot.yandex.net 経由で Yandex Station とスマートホームを操作します	✅ navig-alice	ソースから（まだ PyPI では公開されていません）
navig-antivirus	ブラウザー拡張機能のマルウェア／PUP スキャン、Chrome 拡張機能レジストリの監査、Chrome プロファイルインデックスの復旧などを行います…	✅ navig-antivirus	pip install navig-antivirus（navig と併用：navig[antivirus]）
navig-audio	テキストの読み上げ、音声の文字起こし、音楽や効果音の生成、ビートの分析、ポッドキャストのレンダリングを独立したプラグインとして行います…	✅ navig-audio	pip install navig-audio（navig と併用：navig[voice]）
navig-blackbox	あらゆる Python アプリ向けの、単独で使える無料のフライトレコーダー兼クラッシュ用ブラックボックス：追記専用イベントログ、sys.excepthook によるクラッシュ…	✅ navig-blackbox · nbb	pip install navig-blackbox（navig と併用：navig[blackbox]）
navig-bookmarks	ローカルのブックマークマネージャー：任意のブラウザーや HTML エクスポートからのインポート、全文検索、AI によるフォルダー構成案、タグ付けなど…	✅ navig-bookmarks	pip install navig-bookmarks（navig と併用：navig[bookmarks]）
navig-browser	分離された Chrome／Edge／Brave または Electron アプリを起動し、CDP 経由で操作し、名前付きプロファイルを保持して、対象だけを終了します…	✅ navig-browser	pip install navig-browser（navig と併用：navig[stealth]）
navig-cabinet	書類をひとつのプラグインで管理：身分証やパスポートのスキャン、医療記録などの重要ファイルを保管する暗号化キャビネット…	✅ navig-cabinet	pip install navig-cabinet（navig と併用：navig[cabinet]）
navig-calendar	予定の一覧表示／追加／同期（Google Calendar、CalDAV、ICS）	✅ navig-calendar	pip install navig-calendar
navig-chats	AI との会話を保存するローカルライブラリ：ChatGPT のデータエクスポートをインポートし、NAVIG を使ってページからチャットを保存します…	✅ navig-chats	pip install navig-chats（navig と併用：navig[chats]）
navig-companion	NAVIG の音声コンパニオン — 話す、要約する、考える、クイズ、音楽	— navig companion を追加	ソースから（まだ PyPI では公開されていません）
navig-contacts	navig contacts：アドレス帳と、dispatch が照合に使うエイリアスからルートへの対応表をひとつのストアで管理	✅ navig-contacts	pip install navig-contacts
navig-debrief	作業セッションを視覚的に提示：文字起こしの事実からスライドデッキを作成（navig debrief）し、完全な HTML レポートも提供します…	✅ navig-debrief	pip install navig-debrief（navig と併用：navig[debrief]）
navig-dedupe	写真、動画、音声、あらゆるファイルから知覚的な重複を検出する、無料で単独利用可能なツール	✅ navig-dedupe · ndup	pip install navig-dedupe（navig と併用：navig[dedupe]）
navig-devhost	任意のローカル開発サーバーに、信頼された HTTPS 経由で実際の .test ドメインをワンコマンドで設定します（hosts + mkcert + raw TLS relay）…	✅ navig-devhost	pip install navig-devhost
navig-devnet	開発者／運用者向けのネットワーク調査：DNS／WHOIS／SSL の検索と、SSRF 対策済み HTTP リピーターを、独立した navig-devnet として提供…	✅ navig-devnet	pip install navig-devnet（navig と併用：navig[devnet]）
navig-distribution	NAVIG OS 向けの配信機能：プロジェクト単位のチャネル調査、適格性確認、キャンペーン、ブロック単位のコンテンツ、アイデンティティ…	— navig distribution を追加	ソースから（まだ PyPI では公開されていません）
navig-download	汎用メディアダウンローダー（yt-dlp）：YouTube、TikTok、その他の対応サイトから動画、音声、ファイルをダウンロード	✅ navig-download	pip install navig-download（navig と併用：navig[download]）
navig-ebay	eBay の公式 Sell API（下書き、公開、価格、注文）を使って販売し、navig ebay に統合	✅ navig-ebay	pip install navig-ebay（navig と併用：navig[ebay]）
navig-email	Gmail のメール管理：ルール、監視、ラベル、統計、ダイジェスト、下書き — 独自の navig-email コマンドを提供（Gmail アプリパスワード経由で…）	✅ navig-email	pip install navig-email
navig-explore	あらゆるフォルダーに対応した、汎用のローカルメディア／データエクスプローラー	✅ navig-explore	pip install navig-explore
navig-games	無料ゲームを積極的に探して自動取得します（現在は Epic、次に GOG／Amazon／Steam）。ゲームライブラリの管理にも対応	✅ navig-games	pip install navig-games（navig と併用：navig[games]）
navig-generate	独自のプロバイダーキーで画像、動画、音声を生成し、好みのバリエーションを保存して、カットやエフェクトなどで編集できます…	✅ navig-generate	pip install navig-generate（navig と併用：navig[generate]）
navig-github	GitHub のあらゆる操作に対応するツールボックス（バックアップ、ミラー、エクスポート、管理）：独自の navig-github コマンドと、navig 内の navig github を提供	✅ navig-github	pip install navig-github（navig と併用：navig[github]）
navig-glass	NAVIG Glass 連携：スタンドアロンビューアーの検出、NAVIG 経由でのファイル表示、NAVIG がなくても Glass を完全に利用できる状態の維持	— navig glass を追加	ソースから（まだ PyPI では公開されていません）
navig-google	Gemini API 経由で Google Search に基づいた AI 回答を生成：出典の引用、キー 1 つ、リクエスト単位の課金…	✅ navig-google	ソースから（まだ PyPI では公開されていません）
navig-home	家全体を管理するひとつのコントロールプレーン：LAN 上のすべてのデバイスを検出し、インベントリを管理し、Livebox DHCP の正確な情報を読み取ります…	✅ navig-home	ソースから（まだ PyPI では公開されていません）
navig-lights	ランプを操作：LAN API または開発者向けクラウド経由の Govee、および Home Assistant が認識するあらゆる機器に対応する、シンプルなブリッジ…	✅ navig-lights	ソースから（まだ PyPI では公開されていません）
navig-matrix	navig 向け Matrix メッセージングインターフェイス — ルーム、招待、トークン、管理、受信トレイとの連携を独立したプラグインとして提供	— Deck のインターフェイス	pip install "navig[matrix]"
navig-media	NAVIG のメディア機能をひとつのインストールに集約：画像と動画の生成、音声と音楽、執筆、そしてそれらを組み立てるパイプライン…	✅ navig-media	pip install navig-media
navig-media-core	NAVIG のメディアパッケージを支える共有メディアエンジン — メディアタイプ、生成器レジストリ、生成…	— 共有ライブラリ	pip install navig-media-core
navig-menu	AI を中心に設計されたメニュービルダー — あらゆるプロジェクトの技術スタックを自動検出し、レイアウトなどを備えた高品質な対話型ターミナルメニューを構築…	✅ navig-menu · nm	npm i -g navig-menu
navig-mini	Raspberry Pi、NAS、低消費電力デバイス向けの軽量 AI エージェントデーモン	✅ navig-mini	pip install navig-mini
navig-mobile	Android と iOS デバイス向けのプロ仕様の操作機能：接続、デバイス情報、アプリ、ファイルの取得、スクリーンショット、バックアップ、フォレンジック…	✅ navig-mobile	pip install navig-mobile（navig と併用：navig[mobile]）
navig-msstore	NAVIG から Microsoft Store への公開操作を行うコマンド。msstore-publish ブロックをラップします	✅ navig-msstore	pip install navig-msstore
navig-notes	このコンピューターで使えるウェブ付箋：NAVIG Dock が、ページ、サイト、またはあらゆる場所で残したメモをすべて同期します…	✅ navig-notes	pip install navig-notes（navig と併用：navig[notes]）
navig-obs	navig から OBS Studio を操作 — シーン、ソース、配信、録画、スタジオモード、obs-websocket v5 の全機能を独立した…	✅ navig-obs	pip install navig-obs
navig-pentest	許可された対象に限って使える攻撃的セキュリティツールキット：パッシブな偵察（RDAP／whois、DNS、crt.sh サブドメイン、HTTP フィンガープリント）…	✅ navig-pentest · navig-warroom · warroom-osint	pip install navig-pentest
navig-perplexity	調査、記事、マーケティングコピー、ネーミング、比較、批評などの知的作業を個別に委任します…	✅ navig-perplexity	ソースから（まだ PyPI では公開されていません）
navig-pipeline	コンテンツ制作パイプライン：ビートに合わせてカットした縦型ショート動画、ナレーション付きリール、字幕とフック、ダウンロード → …	✅ navig-pipeline · navig-content	pip install navig-pipeline
navig-router	NAVIG Router：すでにキーを持っているすべてのプロバイダーに対応した、OpenAI および Anthropic 互換のネイティブ LLM エンドポイントをひとつ提供…	— navig router を追加	ソースから（まだ PyPI では公開されていません）
navig-sessions	CDP 経由で VS Code 上に開いている Claude Code セッションを読み取り、完了させます：アイドル状態の各セッションに完了プロンプトを 1 つ送信し、作業中の…	✅ navig-sessions	ソースから（まだ PyPI では公開されていません）
navig-social	ソーシャルネットワーク全体で投稿を作成、予約、公開（Studio + 1 回の呼び出しで一括配信）	✅ navig-social	pip install navig-social（navig と併用：navig[social]）
navig-tasks	Navig-tasks：NAVIG 向けのプロジェクト単位のタスク、トリガー、アクション、Telegram によるレビューの流れ	— navig tasks を追加	ソースから（まだ PyPI では公開されていません）
navig-telegram	navig 向け Telegram インターフェイス — ボット管理、セッション、ステータス、MTProto のユーザーアカウント操作を独立したプラグインとして提供	— Deck のインターフェイス	pip install "navig[telegram]"
navig-text	AI テキスト生成（下書き／記事／キャプション／概要）と、navig design（エージェントによる HTML／CSS の再スタイル設定とデザイントークン）を提供…	✅ navig-text	pip install navig-text
navig-tv	ADB 経由で Fire TV または Android TV を完全に操作 — 電源、方向キー、メディアキー、アプリ起動、テキスト入力、音量など…	✅ navig-tv	ソースから（まだ PyPI では公開されていません）
navig-vault	無料で単独利用できる暗号化開発者向けシークレットマネージャー（Doppler／1Password-CLI／Infisical クラス）	✅ navig-vault · nv	pip install navig-vault
navig-video	テキスト、プレートなどを含むワークスペースから、チャネルの動画フォーマット（キネティックエピソード、速報、モーションカード）をレンダリングします…	✅ navig-video	pip install navig-video（navig と併用：navig[video]）
navig-vm	検証済みクラウドイメージからローカルの VMware Workstation 仮想マシンを作成し、初回起動時に cloud-init でプロビジョニングして操作します…	✅ navig-vm	pip install navig-vm（navig と併用：navig[vm]）
navig-voice	NAVIG 向けのローカル音声スタックを navig assistant として提供：ウェイクワード、音声認識、スキル付きルールベース NLU、TTS…	✅ navig-voice	ソースから（まだ PyPI では公開されていません）
navig-youtube-music	YouTube Music デスクトップアプリ（Venipa ytmdesktop2）を、認証済みローカル API と既存の CDP エンドポイント経由で操作します…	✅ navig-youtube-music	ソースから（まだ PyPI では公開されていません）

エージェントランタイム

NAVIG には、永続的なバックグラウンドプロセスとして実行される自律型エージェントレイヤーが搭載されています。

# One-time setup: write ~/.navig/agent/config.yaml and create runtime directories
navig agent install

# Optional: register as an OS service (starts on boot)
navig service install
navig service start

# Check state
navig agent status

動作モード：supervised（デフォルト。アクションを確認します）、autonomous（プロンプトなしで実行します）、observe-only（読み取りと報告のみ行い、書き込みはしません）。 パーソナリティプロファイル：friendly、professional、witty、paranoid、minimal。

詳しくは、完全なリファレンスであるdocs/agent/install.mdをご覧ください。

---

AI とチャットインターフェース

NAVIG では、次の方法でオペレーターレイヤーを利用できます。

• CLI（navig ask）
• Telegram（navig gateway経由）
• Matrix
• MCP 互換のエディター（Cursor、Claude Desktop、VS Code）

navig ask "Why does this container keep restarting?"

AI レイヤーは、推論、コンテキスト、ワークフローの実行を支援します。オペレーターによる直接の制御に取って代わるものではありません。責任を負い、指揮を執るのはオペレーターです。

---

クラウドルーティング（relay.navig.run）

NAVIG のホスト型 Deck はrelay.navig.runにあります。静的な React アプリと、デーモンの API キー（および Telegram の user_id）を現在の公開 URL に対応付ける小さなブローカー（Cloudflare Pages Functions + D1）で構成されています。デーモンは起動のたびにブローカーへ自身を登録します。Deck と Telegram Mini App は、ブローカーを介して「デーモンの場所」を解決します。デーモンのデータがマシンの外部に送信されることはありません。ブローカーが保存するのはルーティングメタデータ（api_key の SHA-256、現在の公開 URL、Telegram の紐付け情報）のみです。

モード — いずれかを選択してください

モード	使用するケース	有効化方法	サブスクリプションが必要ですか？
Lighthouse (推奨)	トンネルもドメインも使わず、常時アクセス（Telegram / SMS / リモート Deck）したい場合。	navig lighthouse deploy を実行すると、ご自身の Cloudflare アカウントに小さなエッジをデプロイします（Node/wrangler は不要）。ブレインは WebSocket 接続を 1 つ使ってエッジに接続します。docs/LIGHTHOUSE.mdをご覧ください。	不要 — ご自身の Cloudflare 上でセルフホストでき、誰でも無料で利用できます。
cloudflared / hosted relay	ノート PC、自宅のマシンなど、NAT の内側にある環境。公開 IP もドメインも不要です。	デーモンが cloudflared を起動し、無料の *.trycloudflare.com クイックトンネルを作成します。手動で実行する場合：navig cloud connect。	新規 Solo ユーザーと有効なサブスクリプション契約者は無料です。契約が失効した場合は 30 日間の猶予期間があります。買い切りプランのみの購入者は、代わりに Lighthouse/Tailscale でセルフホストしてください。
Tailscale Funnel	Mini App 用の無料で安定した、サブスクリプション不要の公開 URL が必要な場合。	navig cloud tailscale --enable を実行して Tailscale Funnel 経由で *.ts.net URL を用意し、次に navig miniapp register を実行して BotFather に登録します。	不要 — ダイレクトモードのため、ブローカーは関与しません。
direct（独自ドメイン）	公開ドメインとリバースプロキシ（nginx、Caddy、Traefik）を備えた VPS を利用する場合。	navig cloud direct https://navig.example.com を実行すると、デーモンは cloudflared を完全にスキップし、ブローカーに URL を登録します。また、systemd の Environment= 行から $NAVIG_PUBLIC_URL も取得します。	不要 — ダイレクトモードのため、ブローカーは関与しません。
off	完全にローカルのみで利用する場合。ブローカーとは一切通信しません。	navig cloud disconnect を実行します（または ~/.navig/config.yaml で cloud.enabled: false に設定します）。	不要。

サブスクリプションと買い切りの違い：ホスト型クラウドリレーは、 毎月コストが発生する唯一の機能です。そのため、サブスクリプション機能となっています。 買い切りパックの購入者は、ローカルアプリを永久に利用でき、 Tailscale コマンドを 1 つ実行するだけで Mini App をセルフホストできます。無料で、 安定しており、こちらにはコストがかかりません。構成全体についてはdocs/CLOUD.mdを ご覧ください。

3つのコマンドで常時稼働（独自のエッジと独自のDeck）

NAVIGはあなた自身のCloudflareアカウントで完全にセルフホストします。安定したURLを持つ2つの小規模なデプロイと、外部へ接続するあなたのブレインで構成されます。

navig lighthouse login     # 1. EDGE: API uplink (Worker + Durable Object). Opens
                           #    Cloudflare → click Authorize → deploys + sets the
                           #    Telegram webhook. (Or: navig lighthouse deploy --token <t>)
navig miniapp deploy       # 2. DECK: builds the UI (static export) → your own
                           #    Cloudflare Pages, bakes the edge URL in (auto-targets
                           #    your brain) → sets the bot's Mini App button.
navig gateway start        # 3. BRAIN: your daemon dials OUT to the edge. Nothing inbound.

ボットを開き、メニューボタンをタップすると、あなたのエッジを通じてあなたのブレインと通信するあなたのDeckが表示されます。トンネルもポートフォワーディングもドメインも不要で、どこからでもアクセスできます。navig lighthouse url を実行すると、すべての受信フックが表示されます（Telegramは自動的に設定されます。SMSを使う場合のみ、SMSフックをTwilioに貼り付けてください。ソーシャルパブリッシャーは送信専用のため、トークンだけでWebhookは不要です）。

2つのデプロイで使うCloudflare認証情報は1つだけで、wranglerは不要です。lighthouse deploy／login と miniapp deploy はどちらもCloudflare REST API経由でアップロードし、同じ認証情報（"Edit Cloudflare Workers" テンプレートを使ったAPIトークン、または lighthouse login で取得したOAuthトークン）を再利用します。Deckのビルドに必要なのは Node 18+ だけです（miniapp deploy）。アップロードはエッジと同様に、Nodeもwranglerも必要ありません。（必要に応じて、miniapp deploy --wrangler をCloudflare Pagesの代替手段として使えます。）

ポートとファイアウォール（早見表）

モード	受信	送信	デーモンのバインド先
cloudflared	なし	443 → *.cloudflare.com（cloudflaredが送信WebSocketを開きます）	127.0.0.1:8765（ループバックのみ）
direct	443 → お使いのVPS（nginx/Caddyで終端）	443 → relay.navig.run（60秒ごとにハートビート）	127.0.0.1:8765（お使いのプロキシが443からここへ転送します）
off	なし	なし	127.0.0.1:8765（マシン内のみ）

デーモン自体がパブリックインターフェースにバインドすることは決してありません。directモードで 0.0.0.0:443 をリッスンするのはリバースプロキシです。多層防御により、プロキシの設定を誤っても、デーモンのソケットはループバックに留まります。

クイックコマンド

navig lighthouse login        # recommended: your own Cloudflare edge (browser auth)
navig lighthouse url          # show every inbound hook + the one stable edge URL
navig miniapp deploy          # deploy your own Deck UI → bot's Mini App button
navig cloud connect           # turn cloudflared mode on (default)
navig cloud direct https://navig.example.com   # switch to VPS direct mode
navig cloud direct --clear    # revert direct mode back to cloudflared
navig cloud status            # show mode, public URL, last heartbeat
navig cloud disconnect        # full off (no broker, no tunnel)
navig cloud key --reveal      # print the api_key (sensitive)

nginx/Caddyの設定例、Environment=NAVIG_PUBLIC_URL=... を含むsystemdユニットのテンプレート、セキュリティモデル、トラブルシューティングなど、運用者向けの完全なガイドについては、docs/CLOUD.md をご覧ください。

---

設定

グローバル設定は ~/.navig/ にあります。NAVIG_CONFIG_DIR で上書きできます。

~/.navig/
├── config.yaml       ← main config
├── vault/            ← encrypted credentials
├── sessions/
├── workspace/
│   ├── SOUL.md       ← persistent operator identity
│   └── HEARTBEAT.md
└── logs/

プロジェクト固有の設定で上書きするには、リポジトリのルートに .navig/ ディレクトリを配置します。プロジェクト設定はグローバル設定より優先されます。

docs/user/CONFIG_SCHEMA.md と docs/user/HANDBOOK.md をご覧ください。

---

ドキュメント

ガイド
インストール	docs/user/INSTALLATION.md
クイックリファレンス	docs/user/QUICK_REFERENCE.md
CLIコマンド	docs/user/CLI_COMMANDS.md
ハンドブック	docs/user/HANDBOOK.md
トラブルシューティング	docs/user/troubleshooting.md
Telegramのセットアップ	docs/features/TELEGRAM.md
エージェントランタイム（agent install）	docs/agent/install.md
本番環境へのデプロイ	docs/dev/PRODUCTION_DEPLOYMENT.md
移行ガイド	docs/dev/MIGRATION_GUIDE.md
プラグイン／パックの開発	navig-registry

---

開発

# Lint
ruff check navig tests
ruff format --check navig tests

# Test
pytest

# Build
python -m build

PRを送る前のクイックチェック：

python -c "import navig"             # no import errors
navig --help                         # CLI loads in < 1s
pytest tests/ -q                     # all green

コントリビューションのワークフロー、ブランチモデル、コミット規約の詳細については、CONTRIBUTING.md をご覧ください。

---

コミュニティとサポート

チャネル
バグ報告と機能リクエスト	GitHub Issues
アイデアとディスカッション	GitHub Discussions
お知らせ	t.me/navigrun
コミュニティグループ	t.me/+OyFMwN66c3M0NTk0
セキュリティ報告	SECURITY.md

---

プロジェクト構成

navig/
├── navig/               # Main Python package
│   ├── cli/             # CLI app, commands registry, help system
│   ├── commands/        # CLI command modules (one file per resource)
│   ├── agents/          # Specialist agents (inbox router, etc.)
│   ├── memory/          # Conversation store, knowledge base, RAG, embeddings
│   ├── providers/       # AI provider clients, fallback manager, OAuth
│   ├── gateway/         # Chat gateway (Telegram, Matrix) integrations
│   ├── onboarding/      # First-run setup engine and wizard steps
│   ├── daemon/          # Background service entry point
│   ├── core/            # Config loader, migrations, crash handler
│   └── resources/       # Default prompts, personas, assets
├── sdk/                 # Pointer to the SDK in navig-run/registry
├── scripts/             # Install and deployment scripts
├── deploy/              # Docker, systemd, hardening configs
├── docs/                # Documentation
├── packages/            # Optional add-on packages
└── tests/               # pytest test suite

---

スポンサー

NAVIG は個人によって開発され、オープンソースとして公開されています。時間の節約やミスの防止につながったり、ワークフローに欠かせないものになったりした場合は、ぜひご支援ください。

  

ティア
📡 ウォッチャー	$5/mo	シンプルなご支援です。バッジと、希望者は支援者欄へのお名前掲載。
⚡ ノードオペレーター	$10/mo	実際のワークフローでご利用いただいています。ベータ版の先行提供と開発アップデート。
🏗️ システムアーキテクト	$25/mo	長期的なご支援です。ロードマップへの提案と非公開の変更履歴。
⚡ シグナルブースト	$10 one-time	少額の直接支援です。
🚀 フィーチャースプリント	$50 one-time	集中的な開発を支援します。
🌐 ファウンディングノード	$100 one-time	FOUNDERS.md に恒久的にお名前を掲載します。人数限定です。

詳細は FUNDING.md をご覧ください。

---

セキュリティ

脆弱性は非公開でご報告ください。SECURITY.md をご覧ください。

---

ライセンス

Apache-2.0 — LICENSE をご覧ください。

ブランドの使用と公式ビルドの識別については、TRADEMARK.md · GOVERNANCE.md をご覧ください。

---

@miztizm が Forge でコードを作成