Skip to content

commands.md

Latest commit

 

History

History
90 lines (64 loc) · 2.21 KB

commands.md

File metadata and controls

90 lines (64 loc) · 2.21 KB

Command Reference

Profile Management

gascli add <name> [git-name] [email|pat] [gpg-key] [--pat TOKEN]
gascli list | gascli ls
gascli current
gascli remove <name>

Name is required; git-name, email, and gpg-key are optional. Tokens starting with ghp_ are auto-detected as PAT: gascli add work ghp_xxx or gascli add work "John Doe" ghp_xxx. Add email later with add-email.

PAT (Personal Access Token)

gascli pat set <profile> <token>
gascli pat clear <profile>

For HTTPS authentication. Stored in ~/.gascli/config.json and ~/.gascli/credentials-{profile}.

Directory-Based Switching (Git includeIf)

# Primary workflow - set up once, automatic thereafter
gascli auto <directory> <profile>
gascli auto-list
gascli auto-remove <directory>

Creates .gitconfig-{profile} files and adds includeIf directives. Git automatically loads the correct config based on repository location.

Manual Switching

gascli switch <profile> [email]
gascli --auto-ssh switch <profile>  # Also adds SSH key to keychain

Modifies global git config. Use auto for directory-based switching instead.

Email Management

gascli add-email <profile> <email>
gascli remove-email <profile> <email>
gascli list-emails <profile>

Import/Export

gascli export [file]     # Prints to stdout if no file
gascli import <file>

Repo Setup (gh)

gascli gh

Scans .git/config for remote origin URL, extracts GitHub username, finds matching profile (by git-name), and configures:

  • git config user.name (GitHub username)
  • git config user.email (profile primary email)
  • git remote set-url origin https://USER:$PAT@github.com/USER/REPO.git

If no profile matches the GitHub username, lists profiles and prompts for selection. Run from repo root.

Global Flags

  • --auto-ssh, -s: Add SSH key to platform keychain
  • --yes, -y: Skip confirmations
  • --help, -h: Command help
  • --version, -v: Show version

SSH Configuration

Automatically creates entries in ~/.ssh/config:

Host github.com-{profile}
    HostName github.com
    User git
    IdentityFile ~/.ssh/id_{profile}
    IdentitiesOnly yes

Use in git URLs: git@github.com-work:user/repo.git