hosts.json

Reference for user-level remote host metadata.

hosts.json stores named remote host entries used by remote fields in distribution config.

Default location:

~/.divekit/hosts.json

Recommended management command:

divekit auth

Format

{
  "version": "1.0",
  "hosts": {
    "gitnrw": {
      "host": "https://gitlab.git.nrw/",
      "tokenAt": "DIVEKIT_API_TOKEN",
      "maxWorkers": 8,
      "rateLimitDelayMs": 250,
      "enableConcurrency": true
    }
  }
}

Keys

Key	Type	Notes
`version`	string	Current format version. Use `"1.0"`.
`hosts`	object	Map of host alias to host definition.
`hosts.<alias>.host`	string	Base URL of the GitLab or Git provider instance.
`hosts.<alias>.tokenAt`	string	Key name used to resolve the stored token.
`hosts.<alias>.maxWorkers`	integer	Optional per-host concurrency limit.
`hosts.<alias>.rateLimitDelayMs`	integer	Optional delay between requests in milliseconds.
`hosts.<alias>.enableConcurrency`	boolean	Optional concurrency toggle for that host.

Security Notes

hosts.json stores metadata and token references, not raw token values.
Divekit prefers the OS credential manager for actual token storage and falls back only when no keychain/keyring integration is available.
divekit auth unset <host> removes the configured host and deletes the stored token entry.

Last modified June 5, 2026: docs(plugin): document wizard result metadata (88523bc)