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