@gbasin/agentboard 0.2.4 → 0.2.6

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.
Files changed (2) hide show
  1. package/README.md +12 -0
  2. package/package.json +5 -5
package/README.md CHANGED
@@ -4,6 +4,7 @@
4
4
  [![npm](https://img.shields.io/npm/v/@gbasin/agentboard?logo=npm)](https://www.npmjs.com/package/@gbasin/agentboard)
5
5
  [![License: MIT](https://img.shields.io/github/license/gbasin/agentboard)](https://github.com/gbasin/agentboard/blob/master/LICENSE)
6
6
  [![TypeScript](https://img.shields.io/badge/TypeScript-5.x-3178c6?logo=typescript&logoColor=white)](https://www.typescriptlang.org/)
7
+ [![Ask DeepWiki](https://deepwiki.com/badge.svg)](https://deepwiki.com/gbasin/agentboard)
7
8
 
8
9
  Agentboard is a Web GUI for `tmux` that's optimized for agent TUI's (`claude`, `codex`, etc). A lighter-weight, agent-optimized alternative to Blink, Termux, etc.
9
10
 
@@ -56,6 +57,14 @@ Run your desktop/server, then connect from your phone or laptop over Tailscale/L
56
57
 
57
58
  ## Install
58
59
 
60
+ ### Homebrew
61
+
62
+ ```bash
63
+ brew tap gbasin/tap
64
+ brew install agentboard
65
+ agentboard
66
+ ```
67
+
59
68
  ### npm
60
69
 
61
70
  ```bash
@@ -125,6 +134,7 @@ AGENTBOARD_REMOTE_STALE_MS=45000
125
134
  AGENTBOARD_REMOTE_SSH_OPTS=-o BatchMode=yes -o ConnectTimeout=3
126
135
  AGENTBOARD_REMOTE_ALLOW_ATTACH=false
127
136
  AGENTBOARD_REMOTE_ALLOW_CONTROL=false
137
+ AGENTBOARD_LOG_WATCH_MODE=watch
128
138
  ```
129
139
 
130
140
  `HOSTNAME` controls which interfaces the server binds to (default `0.0.0.0` for network access; use `127.0.0.1` for local-only).
@@ -159,6 +169,8 @@ All persistent data is stored in `~/.agentboard/`: session database (`agentboard
159
169
 
160
170
  `AGENTBOARD_REMOTE_ALLOW_CONTROL` enables destructive remote session management (create, kill, rename) via the UI. Setting this to `true` implies `REMOTE_ALLOW_ATTACH=true`. Kill and rename are restricted to agentboard-managed sessions — externally-discovered remote sessions cannot be killed or renamed even with control enabled.
161
171
 
172
+ `AGENTBOARD_LOG_WATCH_MODE` selects the log detection strategy: `watch` (default) uses `fs.watch` for instant file-change detection, `poll` falls back to periodic directory scanning. Use `poll` if you experience issues with filesystem notifications (e.g., on network-mounted home directories). On Linux, watch mode automatically includes a 15-second fallback poll since `fs.watch({ recursive: true })` has known platform bugs.
173
+
162
174
  **SSH multiplexing (recommended):** Each poll cycle opens SSH connections to every remote host. Enable SSH connection multiplexing to reuse connections and reduce overhead from ~200-500ms to ~5ms per poll. Add to your `~/.ssh/config`:
163
175
 
164
176
  ```
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "@gbasin/agentboard",
3
- "version": "0.2.4",
3
+ "version": "0.2.6",
4
4
  "type": "module",
5
5
  "description": "Web GUI for tmux optimized for AI agent TUIs",
6
6
  "author": "gbasin",
@@ -20,10 +20,10 @@
20
20
  "bun": ">=1.3.6"
21
21
  },
22
22
  "optionalDependencies": {
23
- "@gbasin/agentboard-darwin-arm64": "0.2.4",
24
- "@gbasin/agentboard-darwin-x64": "0.2.4",
25
- "@gbasin/agentboard-linux-x64": "0.2.4",
26
- "@gbasin/agentboard-linux-arm64": "0.2.4"
23
+ "@gbasin/agentboard-darwin-arm64": "0.2.6",
24
+ "@gbasin/agentboard-darwin-x64": "0.2.6",
25
+ "@gbasin/agentboard-linux-x64": "0.2.6",
26
+ "@gbasin/agentboard-linux-arm64": "0.2.6"
27
27
  },
28
28
  "scripts": {
29
29
  "dev": "concurrently -k \"bun run dev:server\" \"bun run dev:client\"",