agentstuff 0.1.0
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 +53 -0
- package/dist/index.js +82137 -0
- package/package.json +57 -0
package/README.md
ADDED
|
@@ -0,0 +1,53 @@
|
|
|
1
|
+
# Agentstuff
|
|
2
|
+
|
|
3
|
+
Agentstuff connects supported terminal agent sessions on your Mac to the Agentstuff mobile app through an end-to-end encrypted relay. Live bidirectional terminal control—including messages, permissions, and interrupts—is currently available for Claude. Codex sessions retain the existing mirror and continue workflow.
|
|
4
|
+
|
|
5
|
+
## Install
|
|
6
|
+
|
|
7
|
+
Agentstuff requires macOS and [Bun](https://bun.sh/).
|
|
8
|
+
|
|
9
|
+
```sh
|
|
10
|
+
bun add --global agentstuff
|
|
11
|
+
agentstuff setup
|
|
12
|
+
```
|
|
13
|
+
|
|
14
|
+
Setup installs the background service and terminal integration, adds the `ac` shortcut to your shell configuration, and displays a QR code. Scan the QR from the mobile app to connect the Mac directly.
|
|
15
|
+
|
|
16
|
+
Open a new terminal and start a live session:
|
|
17
|
+
|
|
18
|
+
```sh
|
|
19
|
+
cd your-project
|
|
20
|
+
ac
|
|
21
|
+
```
|
|
22
|
+
|
|
23
|
+
Arguments are forwarded unchanged:
|
|
24
|
+
|
|
25
|
+
```sh
|
|
26
|
+
ac --resume
|
|
27
|
+
ac --model opus
|
|
28
|
+
```
|
|
29
|
+
|
|
30
|
+
Use a different shortcut or leave your shell configuration untouched:
|
|
31
|
+
|
|
32
|
+
```sh
|
|
33
|
+
agentstuff setup --alias agent
|
|
34
|
+
agentstuff setup --no-alias
|
|
35
|
+
```
|
|
36
|
+
|
|
37
|
+
Without a shortcut, launch a connected session with `agentstuff claude`.
|
|
38
|
+
|
|
39
|
+
## Commands
|
|
40
|
+
|
|
41
|
+
```text
|
|
42
|
+
agentstuff setup [--alias ac] [--no-alias] [--relay URL]
|
|
43
|
+
agentstuff claude [arguments...]
|
|
44
|
+
agentstuff pair [--reset] [--relay URL]
|
|
45
|
+
agentstuff status
|
|
46
|
+
agentstuff continue <thread-id-or-title>
|
|
47
|
+
```
|
|
48
|
+
|
|
49
|
+
## Security
|
|
50
|
+
|
|
51
|
+
The local channel is bound to loopback and authenticated with the owner-only pairing secret. Relay traffic is end-to-end encrypted; the relay routes ciphertext but cannot read session content.
|
|
52
|
+
|
|
53
|
+
A paired phone can instruct an agent with access to your Mac and development files. Pair only devices you control. Treat the QR code as a full-trust credential and run `agentstuff pair --reset` if a device or pairing code may have been compromised.
|