@agentdeck/setup 1.0.13 → 1.0.14

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 +60 -0
  2. package/package.json +16 -1
package/README.md ADDED
@@ -0,0 +1,60 @@
1
+ # @agentdeck/setup
2
+
3
+ One-command installer for **[AgentDeck](https://github.com/puritysb/AgentDeck)** — put your AI coding agents (Claude Code, Codex, OpenCode) on a physical control surface: Stream Deck, tablets, e-ink readers, ESP32 panels, LED matrices, or just your terminal.
4
+
5
+ ## Install
6
+
7
+ ```bash
8
+ npx @agentdeck/setup
9
+ ```
10
+
11
+ That is the whole install, on every platform. The wizard:
12
+
13
+ 1. Checks prerequisites (Node.js 22+, your agent CLIs, platform build tools)
14
+ 2. Installs the [`@agentdeck/bridge`](https://www.npmjs.com/package/@agentdeck/bridge) package globally — this provides the `agentdeck` CLI and the local daemon
15
+ 3. Registers Claude Code lifecycle hooks so sessions report state automatically
16
+ 4. Seeds the local data directory
17
+
18
+ Then start a session through AgentDeck:
19
+
20
+ ```bash
21
+ agentdeck claude # or: agentdeck codex / agentdeck opencode
22
+ agentdeck monitor # terminal dashboard
23
+ ```
24
+
25
+ No Stream Deck required — the daemon is the product; decks and other devices are optional ways to look at it.
26
+
27
+ ## Platform notes
28
+
29
+ **Node.js 22 or later** is required everywhere. Native modules (`node-pty`, `sharp`, `better-sqlite3`) install from prebuilt binaries first; a compiler is only needed if a prebuild is missing for your platform.
30
+
31
+ ### macOS
32
+
33
+ - Nothing else is required to install.
34
+ - Xcode Command Line Tools (`xcode-select --install`) are needed only in two cases: a native-module prebuild fails, or you use the voice features — the on-device voice/judge helper compiles on demand (macOS 26+).
35
+ - Autostart: `agentdeck daemon install` registers a LaunchAgent.
36
+
37
+ ### Windows 11
38
+
39
+ - Install Node.js with `winget install OpenJS.NodeJS`, then run `npx @agentdeck/setup` in PowerShell.
40
+ - Hooks are written as PowerShell one-liners; no bash required at runtime.
41
+ - Autostart: `agentdeck daemon install` registers a per-user Scheduled Task (`AgentDeckDaemon`) — no admin elevation.
42
+ - Details: [Windows guide](https://github.com/puritysb/AgentDeck/blob/master/docs/windows.md)
43
+
44
+ ### Linux
45
+
46
+ - The Elgato Stream Deck desktop app does not exist on Linux, so the Stream Deck plugin is skipped — the daemon, `agentdeck monitor` terminal dashboard, hardware devices, and the Android/iOS companion apps all work.
47
+ - If the prebuilt `node-pty` binary fails: Debian/Ubuntu `sudo apt install build-essential python3`, Fedora `sudo dnf install gcc-c++ make python3`, Arch `sudo pacman -S base-devel python`.
48
+ - Autostart: `agentdeck daemon install` registers a systemd `--user` unit; for headless boot run `loginctl enable-linger $USER` once.
49
+ - Details: [Linux guide](https://github.com/puritysb/AgentDeck/blob/master/docs/linux.md)
50
+
51
+ ## Links
52
+
53
+ - Project website: https://puritysb.github.io/AgentDeck/
54
+ - Repository & docs: https://github.com/puritysb/AgentDeck
55
+ - Mac App Store dashboard (standalone, no Node.js needed): https://apps.apple.com/app/id6784822497
56
+ - Issues: https://github.com/puritysb/AgentDeck/issues
57
+
58
+ ## License
59
+
60
+ MIT
package/package.json CHANGED
@@ -1,8 +1,23 @@
1
1
  {
2
2
  "name": "@agentdeck/setup",
3
- "version": "1.0.13",
3
+ "version": "1.0.14",
4
+ "engines": {
5
+ "node": ">=22"
6
+ },
7
+ "description": "One-command installer for AgentDeck — put AI coding agents (Claude Code, Codex, OpenCode) on physical control surfaces",
4
8
  "type": "module",
5
9
  "license": "MIT",
10
+ "homepage": "https://puritysb.github.io/AgentDeck/",
11
+ "bugs": "https://github.com/puritysb/AgentDeck/issues",
12
+ "keywords": [
13
+ "agentdeck",
14
+ "claude-code",
15
+ "codex",
16
+ "opencode",
17
+ "stream-deck",
18
+ "ai-agents",
19
+ "installer"
20
+ ],
6
21
  "repository": {
7
22
  "type": "git",
8
23
  "url": "https://github.com/puritysb/AgentDeck.git",