# Guv

> Guv runs supported coding agents on the user's computer for Familiar App Jobs. Guv setup is user-owned and interactive. Use these guides when a user asks for help.

Important rules:

- Use the Guv CLI to examine or change Guv configuration. Do not read or edit the credential file directly.
- Do not print or transmit credentials, raw coding-agent output, session identifiers, or private paths.
- Get user approval before you change the selected Handler, coding-agent settings, hooks, plugins, tools, models, or permissions.
- Install only Handler code, hooks, plugins, and skills that the user trusts. They run on the user's machine with the user's credentials.
- Correct the first failed `guv status` line before later skipped lines.
- Report completion only when the App shows `Done` and displays the requested Outcome.

## Setup and support

- [Install and configure Guv](/install.md): Connect App, install Guv, approve the computer, and complete the first Job.
- [Troubleshoot Guv setup](/troubleshooting.md): Match status lines. Repair `auth FAILED` through App-approved Device Authorization.
- [Human setup quickstart](/setup): Follow the four-step setup overview.

## Handler authors

- [Custom Handler guide](/custom-handler.md): Install the SDK, write a Handler, configure it, and learn its runtime limits.

## Optional

- [Full documentation](/docs): Read installation, Handler, and troubleshooting information.
- [Latest Guv release assets](https://github.com/familiar-ai/homebrew-tap/releases/latest): Download direct archives for macOS and Linux.