ZeptapDocs
Commands

doctor

Check the command, PATH, the app, the connection, the license, the phones and the agent skills, and say how to fix what's wrong.

Usage

zeptap doctor [--json]

Options

OptionDescription
--jsonPrint the checks as data: each one's name, ok, warning and detail

Details

Each check prints one line: ok passed, !! is a warning, XX failed.

CheckWhat it looks at
commandThis command's version, variant and location
pathWhether zeptap on PATH is this copy
appWhether Zeptap is installed
server.jsonWhether Zeptap is running: process id, port, socket
versionsWhether the app and the command are the same version
connectionWhether the command can reach the app, over the socket or TCP
licenseWhether the license is active
phonesWhether at least one phone is ready
leasesLeases currently held
agentWhich agent it's running under
skillWhether the agent skill is installed
  • The exit code is non-zero when any check fails. Warnings don't count.
  • When a sandbox blocks the connection, doctor prints the setting that allows it. See Agent sandboxes.

Examples

$ zeptap doctor
ok command: zeptap 0.7.0 (production) at /Applications/Zeptap.app/Contents/Helpers/zeptap
ok path: /Users/you/.local/bin/zeptap
ok app: /Applications/Zeptap.app
ok server.json: pid 4242, port 47801, socket /Users/you/Library/Application Support/Zeptap/run/zeptap.sock, app 0.7.0
ok connection: connected over the Unix socket
ok license: active
...

On this page