Skip to content

repos

Manage git repositories defined in the repos[] section of config.

Subcommands

overseer repos status

Show git status across all managed repos: branch, clean/dirty, and list of changed files.

overseer repos status
overseer repos status --format json

JSON output:

[
  {
    "name": "brain",
    "path": "/Users/you/brain",
    "readonly": false,
    "cloned": true,
    "branch": "main",
    "clean": true,
    "changes": []
  },
  {
    "name": "work-api",
    "path": "/Users/you/repos/work/api",
    "readonly": false,
    "cloned": true,
    "branch": "feature/auth",
    "clean": false,
    "changes": ["M src/auth.go", "?? src/auth_test.go"]
  }
]

overseer repos pull

Pull (or clone if missing) all managed repos. Repos with readonly: true are skipped.

overseer repos pull

overseer repos setup

Apply the configured git profile to each already-cloned repo. Useful after adding a new profile or changing which profile a repo should use.

overseer repos setup

Config

Repos are defined in repos[] in config. See Concepts → Config for all fields.