# CLI Configuration

<!-- FLY-1138: moved here from AGENTS.md ("Dev Override: skipPaths" and
     "Credentials"), which keeps one-line pointers. Setup detail is read on
     demand; the never-commit-secrets guardrail stays eager in Hard Rules. -->

## Dev Override: skipPaths

To prevent `flydocs update` from overwriting paths you're actively developing,
add `artifactOverrides.skipPaths` to `.flydocs/config.json`:

```json
{
  "artifactOverrides": {
    "skipPaths": [".claude/skills/flydocs-workflow/"]
  }
}
```

Paths listed here are excluded from artifact sync. This is CLI-local only —
not stored on the server, not visible in the portal, and preserved across syncs.

## Credentials

Cloud tier requires an API key, stored globally at `~/.flydocs/credentials`
and written by:

- `flydocs init` — interactive setup (recommended)
- `flydocs auth` — set or update key directly

Resolution order:

1. `FLYDOCS_API_KEY` environment variable (CI/CD)
2. `~/.flydocs/credentials` (set by `flydocs init` or `flydocs auth`)
3. `.env.local` (legacy fallback)

If an operation fails with "API key not found", run `flydocs init` or
`flydocs auth`. Never commit credentials to git.