Skip to content

Slice 8: tyto install and tyto doctor - #12

Open
rvegajr wants to merge 1 commit into
slice-7/repairfrom
slice-8/install
Open

rvegajr wants to merge 1 commit into
slice-7/repairfrom
slice-8/install

Conversation

@rvegajr

@rvegajr rvegajr commented Sep 30, 2026

Copy link
Copy Markdown
Member

Stacked on #11. Spec sentences are in docs/IMPLEMENTATION.md §4 Slice 8.

What

  • tyto install
    • Writes ~/.local/bin/tyto, pinned to the Node that installs it. The default Node on a machine can be too old; here it's 18.
    • Installs the tyto skill for Claude Code and Cursor. Copies are tracked by hash in ~/.tyto/installed.json, so a skill the user edited is kept.
    • Replaces step 4 of the web-access rule once, so agents check tyto recipes before browsing.
  • tyto doctor [--fix]
    • Checks Node against the engines range, agent-browser ≥ 0.38.1, Claude Code (needed for compile/repair) and tyto on PATH.
    • Lists Tyto's running agent-browser sessions. --fix closes them so they restart with Tyto's settings. agent-browser stores only a hash of a session's launch settings, so a daemon's timeout can't be read back; the spec sentence is updated to match.
  • README gains an Install section.

Verified on a real machine

  • tyto install wrote the launcher, both skills, and the one-step rule change (diff checked).
  • From a fresh login shell (default Node 18), tyto doctor is all green and tyto recipes runs.
  • The skill appears in Claude Code.

Tests

  • npm run check: 20 files, 166 tests, typecheck clean, gitleaks clean.

🤖 Generated with Claude Code

- install: writes ~/.local/bin/tyto pinned to the installing Node (the
  user's default Node 18 can't run Tyto), the `tyto` skill for Claude Code
  and Cursor (tracked by hash; a skill the user edited is kept), and
  replaces step 4 of the web-access rule once so agents check
  `tyto recipes` before browsing.
- doctor: checks Node against the engines range, agent-browser ≥ 0.38.1,
  Claude Code (compiler), and tyto on PATH; lists Tyto's running
  agent-browser sessions; `--fix` closes them so they restart with Tyto's
  settings (agent-browser stores only a hash of a session's launch
  settings, so the timeout itself can't be read).

Installed for real on the maintainer's machine: from a fresh login shell
(default Node 18) `tyto doctor` is all green and the skill shows up in
Claude Code.

Co-Authored-By: Claude Opus 5.5 (1M context) <noreply@anthropic.com>
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant