Remote script. The install command runs a script downloaded from penelopa.ai on a shared machine, so confirm the script before running it there.
Who it is forAn engineer who runs Codex or Claude Code on a Linux machine where a desktop app is not wanted.
The problemAgent sessions on headless machines are not captured, so their workflows never reach the dashboard.
The outcomeHooks capture events on the headless machine, while the dashboard and Sessions explorer are used from a browser.
What you need first
- A Penelopa account, created during installation
- Codex or Claude Code installed on the machine
- macOS 13.5+, Windows 10 22H2+ or Windows 11 x64 for the desktop app, or Linux x64/arm64 with kernel 4.18+ and glibc 2.28+ for hooks only
- Internet access to penelopa.ai, nodejs.org, the npm registry and Electron release downloads
- About 3 GB of free disk space for desktop builds
Steps
- Run
curl -fsSL https://penelopa.ai/script | sh -s -- --agent claude --no-desktopto install Claude Code hooks without building a client, using the README option table. (inferred, check the README) - Open the Connection page in the web dashboard and continue a session on the machine.
- Run
"$(cat "$HOME/.auto-improve/node-path")" "$HOME/.auto-improve/bin/penelopa.cjs" --diagnoseif no event appears.
Prompt for your agent
In the chigwell/Penelopa.ai repo, install hooks for <agent> with the --no-desktop option, then run the diagnose command. Report which agents are configured and whether any queued data remains.
Caveat. Linux desktop is not included in this release, so headless hook capture is the only Linux option, and the --agent flag form is inferred from the README option table.
Use this in your AI agent
Ask your agent
Using the Deduped MCP, get the setup steps for chigwell/Penelopa.ai and "Capture agent sessions on a machine without desktop"
Add Deduped to Claude Code once
claude mcp add --transport http deduped https://dedupedai.com/mcp
Every Monday: the 5 hottest repos and exactly how to use them. Free, one email a week, unsubscribe anytime.
Get them freeShare: X LinkedIn Hacker News Email Copy link
Third-party repos we don't own. AI-written use cases can be wrong. Disclaimer