Reference
CLI flags
Run octoscope for your own dashboard, or octoscope <username> for anyone's public profile. Flags override the config file for that run.
$ octoscope [flags] [username]
--refresh DUR | Auto-refresh interval (Go duration: 30s, 1m). Floored at 5s. |
--compact | Dense card layout in the Overview tab. |
--public-only | Hide private repos / PRs / issues from the lists. |
--no-sponsor | Skip the sponsor splash for this run. |
--no-color | Force the zero-chroma monochrome theme (also honoured via NO_COLOR). |
--theme NAME | Pick a palette. See Themes. |
--config PATH | Read config from PATH instead of the default location. |
-v · --version | Print the version and exit. |
-h · --help | Print usage and exit. |
Run modes — print and exit
Three flags never open the TUI. They fetch (or read) once, print, and exit:
--theme list | Preview every palette with a colour swatch. No fetch, no auth. |
--plain | A static, human-readable summary. See Scripting. |
--json | The versioned JSON contract for piping. |
!
--plain and --json are mutually exclusive, and neither combines with --theme list. An unknown flag exits with a usage error.