Keyboard shortcuts

Press or to navigate between chapters

Press S or / to search in the book

Press ? to show this help

Press Esc to hide this help

Repos

Repos are directories, not files. Each repo is a git repository stored under repos/<provider>/.

For the local provider, Banco runs git init when a new repo is created. For remote providers (GitHub, GitLab), repositories are cloned via SSH and kept up to date with git fetch on each banco sync.

Repos support the browse command — selecting a repo opens its remote URL (repository page, pull requests, pipelines, etc.) in the system browser.

Git status

Each repo item carries a small git status summary, surfaced in the dashboard and in banco context JSON:

FieldMeaning
branchCurrent branch, or null for a detached HEAD / unreadable repo
dirtytrue when the working copy has uncommitted or untracked changes
unmerged_branchesCount of local branches not merged into the current branch
{
  "name": "my-service",
  "branch": "main",
  "dirty": true,
  "unmerged_branches": 2
}

In the dashboard these render compactly as my-service (main) *↟2* for a dirty working copy and ↟N for unmerged branches.