tailii-host 0.1.0 → 0.1.1
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/README.md +13 -9
- package/package.json +1 -1
package/README.md
CHANGED
|
@@ -1,20 +1,21 @@
|
|
|
1
1
|
# tailii-host
|
|
2
2
|
|
|
3
|
-
Tailii is an iPhone app for controlling Claude Code and Codex sessions running on your own
|
|
3
|
+
Tailii is an iPhone app for controlling Claude Code and Codex sessions running on your own machine.
|
|
4
4
|
|
|
5
|
-
`tailii-host` は、Tailii iPhone
|
|
5
|
+
`tailii-host` は、Tailii iPhone アプリとホストマシン上の Claude Code / Codex セッションをつなぐホスト側ヘルパーです。ホスト側で `npx tailii-host setup` を実行してペアリングします。
|
|
6
6
|
|
|
7
7
|
## Requirements
|
|
8
8
|
|
|
9
9
|
- Node.js 20 以上
|
|
10
|
-
- macOS
|
|
10
|
+
- macOS または Linux(開発・検証は macOS 中心)
|
|
11
11
|
- tmux
|
|
12
|
+
- SSH サーバーが有効であること(macOS では「リモートログイン」を ON)
|
|
12
13
|
- `claude` CLI (Claude Code) がインストール済みでログイン済みであること
|
|
13
14
|
- Tailii iPhone アプリ
|
|
14
15
|
|
|
15
16
|
## Quick start
|
|
16
17
|
|
|
17
|
-
|
|
18
|
+
ホストマシンで次のコマンドを実行します。
|
|
18
19
|
|
|
19
20
|
```sh
|
|
20
21
|
npx tailii-host setup
|
|
@@ -22,7 +23,7 @@ npx tailii-host setup
|
|
|
22
23
|
|
|
23
24
|
表示された QR コードを Tailii アプリで読み取るか、表示されたコードをアプリに入力してペアリングします。
|
|
24
25
|
|
|
25
|
-
`setup` は、アプリが SSH 経由で実行するランチャー(`~/.local/bin/tailii-host`)を自動生成し、あわせて環境診断(tmux / claude CLI /
|
|
26
|
+
`setup` は、アプリが SSH 経由で実行するランチャー(`~/.local/bin/tailii-host`)を自動生成し、あわせて環境診断(tmux / claude CLI / SSH サーバー)を表示します。診断だけを再実行するには:
|
|
26
27
|
|
|
27
28
|
```sh
|
|
28
29
|
npx tailii-host doctor
|
|
@@ -30,17 +31,20 @@ npx tailii-host doctor
|
|
|
30
31
|
|
|
31
32
|
## How it works
|
|
32
33
|
|
|
33
|
-
Tailii
|
|
34
|
+
Tailii はサーバーレス構成で動作し、リレーサーバーは使いません。ホストへの到達性は自宅 LAN や Tailscale など、ユーザー自身のネットワーク環境で確保します。
|
|
34
35
|
|
|
35
|
-
承認フローでは Claude Code の PreToolUse hook を使い、ツール実行を一時停止して構造化イベントを iPhone に転送します。ユーザーは iPhone アプリ上でネイティブに承認または拒否できます。セッションは tmux
|
|
36
|
+
承認フローでは Claude Code の PreToolUse hook を使い、ツール実行を一時停止して構造化イベントを iPhone に転送します。ユーザーは iPhone アプリ上でネイティブに承認または拒否できます。セッションは tmux により維持されるため、接続が切れても継続できます。
|
|
37
|
+
|
|
38
|
+
接続中の出来事は iPhone 側のローカル通知で知らせます。バックグラウンド push 通知は現在準備中の実験的機能で、既定では無効です(ホスト側に APNs 設定が無い場合、送信は行われません)。
|
|
36
39
|
|
|
37
40
|
実行エンジンは、サブスクリプション認証済みの対話型 `claude` CLI です。Agent SDK やヘッドレス実行は使いません。
|
|
38
41
|
|
|
39
42
|
## Commands
|
|
40
43
|
|
|
41
|
-
- `setup`:
|
|
44
|
+
- `setup`: メインのユーザー向けコマンドです。ホストと Tailii iPhone アプリをペアリングします。
|
|
45
|
+
- `doctor`: 環境診断(tmux / claude CLI / SSH サーバー / ランチャー)を実行します。
|
|
42
46
|
- `engine`: Tailii が利用する実行エンジン関連の処理を行います。
|
|
43
|
-
- `serve`:
|
|
47
|
+
- `serve`: ホスト側のローカルサーバーを起動します。
|
|
44
48
|
- `hook`: Claude Code の hook から呼び出され、承認イベントを処理します。
|
|
45
49
|
- `launch`: tmux-backed セッションを起動します。
|
|
46
50
|
- `kick`: セッションやホスト側処理を再開・通知するために使われます。
|