hermesdesk-agent 0.1.0-alpha.10 → 0.1.0-alpha.11
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 +5 -4
- package/bin/hermesdesk.js +2 -1
- package/npm-shrinkwrap.json +2 -2
- package/package.json +1 -1
- package/src/agent.js +4 -3
- package/src/config.js +1 -1
- package/src/permissions.js +23 -6
- package/src/ui/chrome.js +3 -1
- package/src/ui/format.js +2 -2
package/README.md
CHANGED
|
@@ -2,7 +2,7 @@
|
|
|
2
2
|
|
|
3
3
|
[](https://github.com/NKocur/hermesdesk-agent/actions/workflows/ci.yml)
|
|
4
4
|
|
|
5
|
-
**Windows alpha: 0.1.0-alpha.
|
|
5
|
+
**Windows alpha: 0.1.0-alpha.11.** Community client built on Pi; not affiliated with or endorsed by Earendil Works or Nous Research.
|
|
6
6
|
|
|
7
7
|
A running HermesDesk inference gateway is required. This client does not include a hosted model service, server access, or API keys.
|
|
8
8
|
|
|
@@ -18,7 +18,7 @@ hermesdesk.cmd connect
|
|
|
18
18
|
hermesdesk.cmd doctor
|
|
19
19
|
```
|
|
20
20
|
|
|
21
|
-
Alternatively, download and extract a Windows alpha bundle from [Releases](https://github.com/NKocur/hermesdesk-agent/releases) and run `Install Agent.cmd`. A tarball can also be installed directly with `npm.cmd install -g --ignore-scripts ./hermesdesk-agent-0.1.0-alpha.
|
|
21
|
+
Alternatively, download and extract a Windows alpha bundle from [Releases](https://github.com/NKocur/hermesdesk-agent/releases) and run `Install Agent.cmd`. A tarball can also be installed directly with `npm.cmd install -g --ignore-scripts ./hermesdesk-agent-0.1.0-alpha.11.tgz`.
|
|
22
22
|
|
|
23
23
|
There is no default server address. `connect` asks for your HTTPS model endpoint ending in `/v1`. When the server supports browser sign-in, it opens your browser: sign in to HermesDesk and approve the computer. The CLI receives a short-lived, single-use authorization code on a loopback listener and redeems it with PKCE over HTTPS, then discovers the model and saves the credentials encrypted. You do not copy passwords, API keys, or connection codes. The browser and CLI must be on the same computer. Use `--no-browser` to open the printed browser link yourself. On legacy servers without browser sign-in, the API-key setup remains available; `--manual` explicitly selects it. No server credentials are included in this package.
|
|
24
24
|
|
|
@@ -49,7 +49,7 @@ Colors follow the terminal background automatically, using the HermesDesk light
|
|
|
49
49
|
|
|
50
50
|
Escape interrupts work. `/quit` exits; `/new` starts a new conversation and `/resume` opens Pi's session selector. The first interactive startup may download Pi's `fd` helper to this client's own Pi cache. Windows Terminal is recommended. Pi's inherited help and exit hints may still mention `pi`; resume this client with `hermesdesk chat --continue` or `--session ID`.
|
|
51
51
|
|
|
52
|
-
File tools are restricted to the chosen project and reject outside links and protected paths such as `.env`, `.git`, credential files and agent configurations.
|
|
52
|
+
File tools are restricted to the chosen project and reject outside links and protected paths such as `.env`, `.git`, credential files and agent configurations. Edits and shell commands ask for approval by default. Shell commands execute as your user and are **not OS-sandboxed**; after approval they can access anything your account can access. Direct `!` shell shortcuts are disabled so commands use the managed approval path. Project JavaScript extensions, MCP servers and packages are not automatically loaded.
|
|
53
53
|
|
|
54
54
|
The root project's `AGENTS.md` is included as instructions when it is an ordinary allowed file under 64 KiB. Existing global Pi/Claude settings are not imported. This first version does not synchronize HermesDesk chats, workspace memory or Hermes's skill-learning loop.
|
|
55
55
|
|
|
@@ -115,11 +115,12 @@ Use `--continue` or `--session ID` when starting the process to restore an earli
|
|
|
115
115
|
```text
|
|
116
116
|
/permissions ask
|
|
117
117
|
/permissions edits
|
|
118
|
+
/permissions fuck-it
|
|
118
119
|
/permissions read-only
|
|
119
120
|
/permissions show
|
|
120
121
|
```
|
|
121
122
|
|
|
122
|
-
`ask` requests approval for edits and shell commands. `edits` auto-approves workspace file edits while shell commands still ask. `read-only` enables reading and searching and blocks file changes/commands; switch back with `/permissions ask` or `edits`. The header, footer and `/status` follow the current mode. Changes are local to the running CLI process, consume no model calls and add no messages to model history. They are blocked during an active run; finish it or press Ctrl+C first. Menu cancellation leaves the mode unchanged. Launching with `--read-only` locks that restriction until you restart without the flag. Headless permissions stay fixed by launch options, and protected file paths remain blocked.
|
|
123
|
+
`ask` requests approval for edits and shell commands. `edits` auto-approves workspace file edits while shell commands still ask. **Fuck it Mode** (`/permissions fuck-it`) auto-approves both file edits and shell commands. Commands run with your account access, including access outside the workspace. The header/footer name the active mode; switch back with `/permissions ask`. `read-only` enables reading and searching and blocks file changes/commands; switch back with `/permissions ask` or `edits`. The header, footer and `/status` follow the current mode. Changes are local to the running CLI process, consume no model calls and add no messages to model history. They are blocked during an active run; finish it or press Ctrl+C first. Menu cancellation leaves the mode unchanged. Launching with `--read-only` locks that restriction until you restart without the flag. Headless permissions stay fixed by launch options, and protected file paths remain blocked.
|
|
123
124
|
|
|
124
125
|
|
|
125
126
|
Use these inside interactive chat. Commands run locally, consume no model tokens, and change the next request without restarting the conversation:
|
package/bin/hermesdesk.js
CHANGED
|
@@ -85,7 +85,8 @@ const help = `HermesDesk Agent ${VERSION} (Pi-based, Windows first)
|
|
|
85
85
|
hermesdesk config [set KEY VALUE | preset fast|balanced|extended]
|
|
86
86
|
hermesdesk logout
|
|
87
87
|
|
|
88
|
-
|
|
88
|
+
Interactive chat asks before edits and commands by default.
|
|
89
|
+
/permissions fuck-it enables Fuck it Mode; /permissions ask restores approval prompts.
|
|
89
90
|
One-shot runs deny changes by default; --approve-writes permits workspace file edits.
|
|
90
91
|
Headless commands are denied unless --approve-commands explicitly permits them.
|
|
91
92
|
--read-only overrides both pre-approvals. Shell commands are not OS-sandboxed.
|
package/npm-shrinkwrap.json
CHANGED
|
@@ -1,12 +1,12 @@
|
|
|
1
1
|
{
|
|
2
2
|
"name": "hermesdesk-agent",
|
|
3
|
-
"version": "0.1.0-alpha.
|
|
3
|
+
"version": "0.1.0-alpha.11",
|
|
4
4
|
"lockfileVersion": 3,
|
|
5
5
|
"requires": true,
|
|
6
6
|
"packages": {
|
|
7
7
|
"": {
|
|
8
8
|
"name": "hermesdesk-agent",
|
|
9
|
-
"version": "0.1.0-alpha.
|
|
9
|
+
"version": "0.1.0-alpha.11",
|
|
10
10
|
"license": "MIT",
|
|
11
11
|
"dependencies": {
|
|
12
12
|
"@earendil-works/pi-coding-agent": "1.5.0",
|
package/package.json
CHANGED
package/src/agent.js
CHANGED
|
@@ -232,9 +232,10 @@ export async function createRuntime({
|
|
|
232
232
|
apply: (mode) => {
|
|
233
233
|
if (!activeSession)
|
|
234
234
|
throw Error("The session is not ready to change permissions.");
|
|
235
|
-
permissions.change(mode, (next) =>
|
|
236
|
-
|
|
237
|
-
|
|
235
|
+
permissions.change(mode, (next) => {
|
|
236
|
+
if (next.readOnly !== permissions.read().readOnly)
|
|
237
|
+
activeSession.setActiveToolsByName(toolsFor(next));
|
|
238
|
+
});
|
|
238
239
|
},
|
|
239
240
|
}),
|
|
240
241
|
policyExtension({
|
package/src/config.js
CHANGED
package/src/permissions.js
CHANGED
|
@@ -5,11 +5,14 @@ import { chooseItem } from "./ui/menu.js";
|
|
|
5
5
|
export const PERMISSION_MODES = {
|
|
6
6
|
ask: { readOnly: false, approveWrites: false, approveCommands: false },
|
|
7
7
|
edits: { readOnly: false, approveWrites: true, approveCommands: false },
|
|
8
|
+
"fuck-it": { readOnly: false, approveWrites: true, approveCommands: true },
|
|
8
9
|
"read-only": { readOnly: true, approveWrites: false, approveCommands: false },
|
|
9
10
|
};
|
|
10
11
|
const NOTES = {
|
|
11
12
|
ask: "Edits and shell commands ask first.",
|
|
12
13
|
edits: "File edits apply automatically; shell commands ask first.",
|
|
14
|
+
"fuck-it":
|
|
15
|
+
"Auto-approve edits and shell commands; commands run with your account access.",
|
|
13
16
|
"read-only":
|
|
14
17
|
"Read and search only; file edits and shell commands are blocked.",
|
|
15
18
|
};
|
|
@@ -30,12 +33,19 @@ export function createPermissions({
|
|
|
30
33
|
lockedReadOnly,
|
|
31
34
|
read: () => ({ ...current }),
|
|
32
35
|
mode: () =>
|
|
33
|
-
current.readOnly
|
|
36
|
+
current.readOnly
|
|
37
|
+
? "read-only"
|
|
38
|
+
: current.approveWrites && current.approveCommands
|
|
39
|
+
? "fuck-it"
|
|
40
|
+
: current.approveWrites
|
|
41
|
+
? "edits"
|
|
42
|
+
: "ask",
|
|
34
43
|
change(mode, beforeChange = () => {}) {
|
|
35
44
|
const next = Object.hasOwn(PERMISSION_MODES, mode)
|
|
36
45
|
? PERMISSION_MODES[mode]
|
|
37
46
|
: undefined;
|
|
38
|
-
if (!next)
|
|
47
|
+
if (!next)
|
|
48
|
+
throw Error("Usage: /permissions ask|edits|fuck-it|read-only|show");
|
|
39
49
|
if (lockedReadOnly && mode !== "read-only")
|
|
40
50
|
throw Error(
|
|
41
51
|
"This CLI was launched with --read-only. Restart without that flag to permit edits or commands.",
|
|
@@ -63,14 +73,19 @@ export function permissionsCommands({ permissions, apply }) {
|
|
|
63
73
|
);
|
|
64
74
|
};
|
|
65
75
|
pi.registerCommand("permissions", {
|
|
66
|
-
description:
|
|
76
|
+
description:
|
|
77
|
+
"Approval mode: ask, auto-approve edits, Fuck it Mode, or read-only",
|
|
67
78
|
getArgumentCompletions: (prefix) =>
|
|
68
79
|
[...Object.keys(PERMISSION_MODES), "show"]
|
|
69
80
|
.filter((value) => value.startsWith(prefix.trim().toLowerCase()))
|
|
70
|
-
.map((value) => ({
|
|
81
|
+
.map((value) => ({
|
|
82
|
+
value,
|
|
83
|
+
label: value === "fuck-it" ? "Fuck it Mode" : value,
|
|
84
|
+
})),
|
|
71
85
|
handler: async (args, ctx) => {
|
|
72
86
|
try {
|
|
73
87
|
let mode = args.trim().toLowerCase();
|
|
88
|
+
if (/^fuck[ -]+it(?:[ -]+mode)?$/.test(mode)) mode = "fuck-it";
|
|
74
89
|
if (mode === "show") return show(ctx);
|
|
75
90
|
if (!ctx.hasUI || ctx.mode !== "tui")
|
|
76
91
|
throw Error(
|
|
@@ -82,7 +97,7 @@ export function permissionsCommands({ permissions, apply }) {
|
|
|
82
97
|
title: "Permissions",
|
|
83
98
|
subtitle: permissions.lockedReadOnly
|
|
84
99
|
? "This launch is restricted by --read-only."
|
|
85
|
-
: "Applies immediately to this CLI process.
|
|
100
|
+
: "Applies immediately to this CLI process. Fuck it Mode also auto-approves shell commands.",
|
|
86
101
|
items: Object.keys(PERMISSION_MODES)
|
|
87
102
|
.filter(
|
|
88
103
|
(value) =>
|
|
@@ -95,7 +110,9 @@ export function permissionsCommands({ permissions, apply }) {
|
|
|
95
110
|
? "Ask first"
|
|
96
111
|
: value === "edits"
|
|
97
112
|
? "Auto-approve edits"
|
|
98
|
-
: "
|
|
113
|
+
: value === "fuck-it"
|
|
114
|
+
? "Fuck it Mode"
|
|
115
|
+
: "Read-only",
|
|
99
116
|
description: NOTES[value],
|
|
100
117
|
current: permissions.mode() === value,
|
|
101
118
|
})),
|
package/src/ui/chrome.js
CHANGED
|
@@ -58,7 +58,9 @@ export function headerFactory({ version, mode, keyText, read }) {
|
|
|
58
58
|
: "File tools stay inside this workspace. " +
|
|
59
59
|
(mode.short === "asks first"
|
|
60
60
|
? "Edits and commands ask first."
|
|
61
|
-
:
|
|
61
|
+
: mode.short === "Fuck it Mode"
|
|
62
|
+
? "Edits and shell commands run without asking."
|
|
63
|
+
: "Edits apply without asking; commands ask first.");
|
|
62
64
|
const hints = [
|
|
63
65
|
theme.fg("accent", "/limits") + theme.fg("dim", " settings"),
|
|
64
66
|
theme.fg("accent", "/permissions"),
|
package/src/ui/format.js
CHANGED
|
@@ -32,9 +32,9 @@ export function approvalMode({ readOnly, approveWrites, approveCommands }) {
|
|
|
32
32
|
if (approveCommands)
|
|
33
33
|
return {
|
|
34
34
|
tone: "warning",
|
|
35
|
-
short: approveWrites ? "
|
|
35
|
+
short: approveWrites ? "Fuck it Mode" : "commands auto-approved",
|
|
36
36
|
long: approveWrites
|
|
37
|
-
? "
|
|
37
|
+
? "Fuck it Mode (edits and commands auto-approved)"
|
|
38
38
|
: "Commands auto-approved, edits ask",
|
|
39
39
|
};
|
|
40
40
|
if (approveWrites)
|