1# CLI Commands
2
3Dumber provides commands for browser management, history, sessions, and diagnostics.
4
5## Commands
6
7| Command | Description |
8|---------|-------------|
9| `dumber browse` | Launch the graphical browser |
10| `dumber dmenu` | Launcher integration for rofi/fuzzel |
11| `dumber history` | Browse and manage history |
12| `dumber sessions` | Manage browser sessions |
13| `dumber config` | Manage configuration |
14| `dumber doctor` | Check runtime requirements |
15| `dumber setup` | Setup desktop integration |
16| `dumber update` | Check for and install updates |
17| `dumber logs` | View application logs |
18| `dumber purge` | Remove data and configuration |
19| `dumber about` | Show version information |
20| `dumber gen-docs` | Generate documentation from CLI commands |
21| `dumber completion` | Generate shell completions |
22
23## Command Reference
24
25### browse
26
27Launch the graphical browser.
28
29```bash
30dumber browse [url]
31```
32
33### dmenu
34
35Launcher integration for rofi/fuzzel.
36
37```bash
38dumber dmenu [flags]
39```
40
41| Flag | Short | Description |
42|------|-------|-------------|
43| `--interactive` | `-i` | Use interactive TUI mode |
44| `--select` | | Process selection from stdin |
45| `--days` | | Number of days of history to show |
46| `--most-visited` | `-m` | Sort by visit count instead of recency |
47
48**Examples:**
49```bash
50dumber dmenu | rofi -dmenu -show-icons | dumber dmenu --select
51dumber dmenu | fuzzel --dmenu | dumber dmenu --select
52dumber dmenu --interactive
53dumber dmenu --days 7 --most-visited
54```
55
56### history
57
58Browse and manage history.
59
60```bash
61dumber history [flags]
62dumber history stats
63dumber history clear
64```
65
66| Flag | Description |
67|------|-------------|
68| `--json` | Output as JSON |
69| `--max` | Maximum entries to show (default: 50) |
70
71**Subcommands:**
72- `stats` - Show history statistics
73- `clear` - Interactive history cleanup
74
75### sessions
76
77Manage browser sessions.
78
79```bash
80dumber sessions
81dumber sessions list [flags]
82dumber sessions restore <session-id>
83dumber sessions delete <session-id>
84```
85
86**Subcommands:**
87
88| Subcommand | Description |
89|------------|-------------|
90| `list` | List saved sessions |
91| `restore <id>` | Restore a saved session |
92| `delete <id>` | Delete a saved session |
93
94**list flags:**
95
96| Flag | Description |
97|------|-------------|
98| `--json` | Output as JSON |
99| `--limit` | Maximum sessions to show (default: 20) |
100
101### config
102
103Manage configuration.
104
105```bash
106dumber config open
107dumber config status
108dumber config migrate [flags]
109dumber config schema [flags]
110```
111
112**Subcommands:**
113
114| Subcommand | Description |
115|------------|-------------|
116| `open` | Open config file in editor |
117| `status` | Show config status and migration availability |
118| `migrate` | Add missing default settings |
119| `schema` | Show all config keys with types and values |
120
121**migrate flags:**
122
123| Flag | Short | Description |
124|------|-------|-------------|
125| `--yes` | `-y` | Skip confirmation prompt |
126
127**schema flags:**
128
129| Flag | Description |
130|------|-------------|
131| `--json` | Output as JSON |
132
133### doctor
134
135Check runtime requirements and diagnose issues.
136
137```bash
138dumber doctor [flags]
139```
140
141| Flag | Description |
142|------|-------------|
143| `--runtime` | Only run runtime checks (GTK4/WebKitGTK) |
144| `--media` | Only run media checks (GStreamer/VA-API) |
145
146### setup
147
148Setup desktop integration.
149
150```bash
151dumber setup install
152dumber setup default
153```
154
155| Subcommand | Description |
156|------------|-------------|
157| `install` | Install desktop file to ~/.local/share/applications/ |
158| `default` | Set dumber as the default web browser |
159
160### update
161
162Check for and install updates.
163
164```bash
165dumber update [flags]
166```
167
168| Flag | Short | Description |
169|------|-------|-------------|
170| `--force` | `-f` | Force reinstall (skips version check) |
171
172### logs
173
174View application logs.
175
176```bash
177dumber logs [session]
178dumber logs clear [flags]
179```
180
181| Flag | Short | Description |
182|------|-------|-------------|
183| `--follow` | `-f` | Follow log output in real-time |
184| `--lines` | `-n` | Number of lines to show (default: 50) |
185
186**Subcommands:**
187
188| Subcommand | Description |
189|------------|-------------|
190| `clear` | Clear old log files |
191
192**clear flags:**
193
194| Flag | Description |
195|------|-------------|
196| `--all` | Remove all session logs |
197
198### purge
199
200Remove dumber data and configuration.
201
202```bash
203dumber purge [flags]
204```
205
206| Flag | Short | Description |
207|------|-------|-------------|
208| `--force` | `-f` | Remove all items without prompting |
209
210### about
211
212Show version and build information.
213
214```bash
215dumber about
216```
217
218### gen-docs
219
220Generate documentation (man pages or markdown) from CLI commands.
221
222```bash
223dumber gen-docs [flags]
224```
225
226| Flag | Short | Description |
227|------|-------|-------------|
228| `--output` | `-o` | Output directory for generated docs |
229| `--format` | `-f` | Output format: man, markdown (default: man) |
230
231**Supported formats:**
232- `man` - Unix manual pages (groff format)
233- `markdown` - Markdown files (for websites/wikis)
234
235**Examples:**
236```bash
237dumber gen-docs                     # Install man pages to ~/.local/share/man/man1/
238dumber gen-docs --format markdown   # Generate markdown docs
239dumber gen-docs --output ./man      # Generate to local directory
240```
241
242## Environment Variables
243
244Configuration can be overridden via environment variables:
245
246```bash
247DUMBER_LOG_LEVEL=debug dumber browse
248DUMBER_RENDERING_MODE=cpu dumber browse
249```
250
251Pattern: `DUMBER_SECTION_KEY` (uppercase, underscores)