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