Syntax and Commands

🚀Syntax and Commands

Stable

Choose guided setup or one focused provider operation.

Commandcusty configure credentials

📦Category

Configuration

🚀Quick Command

custy configure credentials [set|status|test|remove]

---

Guided setup

Terminal

bash

custy configure credentials

The wizard asks for provider, source, non-secret username, and source metadata. File mode requests the PAT with hidden input and confirmation.

Focused Commands

📋Properties

Property	Type	Description	Default	Required
set	Mutating	Enable GitHub or GitLab. File mode prompts for the token; environment mode stores only a variable name.	—	No
status	Read-only	Show policy and source availability without displaying token values.	—	No
test	Read-only network	Run git ls-remote with the active policy. Dry-run does not read credentials or contact the remote.	--remote origin	No
remove	Mutating	Disable a provider. Add --delete-file only when the external token file should also be removed.	Preserve file	No

🛡️There is no --token option

Custy intentionally accepts a file-backed token only through a hidden prompt. Do not put a PAT in a shell argument, repository URL, message file, or TOML.

Global Dry-Run

Terminal

bash

custy --dry-run configure credentials status
custy --dry-run configure credentials test --remote origin

Dry-run never opens token files, reads token environment values, contacts a remote, writes TOML, or creates/deletes an external credential file.