{
 "schema_version": 1,
 "generated": "2026-10-26",
 "id": "chigwell-penelopa-ai--run-penelopa-hooks-on-headless-machine",
 "repo": "chigwell/Penelopa.ai",
 "repo_url": "https://github.com/chigwell/Penelopa.ai",
 "repo_slug": "chigwell-penelopa-ai",
 "title": "Capture agent sessions on a machine without desktop",
 "page_title": "How to capture agent sessions on a machine without desktop with Penelopa AI",
 "summary": "Install hooks only, with no desktop client, on a server or CI-style machine.",
 "who": "An engineer who runs Codex or Claude Code on a Linux machine where a desktop app is not wanted.",
 "problem": "Agent sessions on headless machines are not captured, so their workflows never reach the dashboard.",
 "outcome": "Hooks capture events on the headless machine, while the dashboard and Sessions explorer are used from a browser.",
 "steps": [
  "Run `curl -fsSL https://penelopa.ai/script | sh -s -- --agent claude --no-desktop` to 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\" --diagnose` if no event appears."
 ],
 "agent_prompt": "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.",
 "agents": [
  "codex",
  "claude-code"
 ],
 "difficulty": "Advanced",
 "time": "45 minutes",
 "basis": "readme",
 "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.",
 "category": "Software and DevOps",
 "tags": [
  "Software and DevOps"
 ],
 "lang": "javascript",
 "requirements": [
  "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"
 ],
 "risk": "sensitive",
 "seen_in_the_wild": false,
 "mentioned_publicly": false,
 "risks": [
  {
   "tag": "remote-script",
   "notice": "The install command runs a script downloaded from penelopa.ai on a shared machine, so confirm the script before running it there."
  }
 ],
 "best": false,
 "score": 0.7,
 "evidence": [],
 "url": "https://dedupedai.com/use-cases/chigwell-penelopa-ai/run-penelopa-hooks-on-headless-machine/",
 "md": "https://dedupedai.com/use-cases/chigwell-penelopa-ai/run-penelopa-hooks-on-headless-machine/index.md",
 "disclaimer": "Deduped lists open-source repositories that belong to other people. We do not own, maintain, audit, or vouch for any of them, and a repo appearing here is not an endorsement or a safety check. The use cases, steps, and prompts are written by AI and may be incomplete, outdated, or just wrong. Where a use case is marked \"Seen in the wild\", we link to public posts where someone described something similar, but we have not verified those posts and the use case itself is still our AI's own write-up. Use all of this at your own risk. Only run code, commands, or agents on systems and accounts you are authorized to use, and read the code and every command before you run it, especially anything that touches credentials, files, or the network. Nothing here is professional, security, legal, or financial advice. All trademarks and project names belong to their respective owners, and their use here does not imply affiliation. Content is provided as is, without warranties of any kind. Found a mistake, a safety problem, or something you want removed? Email hello@dedupedai.com and we will look at it promptly.",
 "api": "https://dedupedai.com/api/v1/usecases/chigwell-penelopa-ai--run-penelopa-hooks-on-headless-machine.json",
 "api_version": "v1"
}