# Command Reference

## Flags

These flags work with the base `dk [search]` command. They forward an action to whatever project you select:

| Flag | Short | Action |
|------|:-----:|--------|
| `--menu` | `-m` | Show the project action menu |
| `--editor` | `-e` | Open in editor |
| `--finder` | `-f` | Open in Finder |
| `--open` | `-o` | Open in DevKeepr |
| `--remote` | `-r` | Open git remote in browser |
| `--bookmark` | `-b` | Toggle bookmark |
| `--hibernate` | `-H` | Hibernate project |
| `--wake` | `-w` | Wake project |
| `--remove` | `-x` | Remove project |
| `--logs` | `-L` | Tail a log file |
| `--actions` | `-a` | Run a stack action |

Short flags can be combined: `dk my-app -efr` opens the editor, Finder, and remote repo in one go.

## Commands

Every action is also available as a standalone command. These default to the current directory but accept an optional path argument.

### Navigation

| Command | Alias | Description |
|---------|:-----:|-------------|
| `dk [search]` | | Fuzzy search and jump to a project |
| `dk menu [path]` | `m` | Interactive action menu |
| `dk list` | | Show help and available commands |

### Project Management

| Command | Alias | Description |
|---------|:-----:|-------------|
| `dk link` | `l` | Track current directory as a project |
| `dk park [dir]` | `p` | Track all subdirectories as projects |
| `dk remove [path]` | `r` | Stop tracking a project |
| `dk bookmark [path]` | `b` | Toggle bookmark |

### Hibernation

| Command | Alias | Description |
|---------|:-----:|-------------|
| `dk hibernate [path]` | `h` | Hibernate project and free disk space |
| `dk wake [path]` | `w` | Wake project and restore dependencies |

### Open

| Command | Alias | Description |
|---------|:-----:|-------------|
| `dk editor [path]` | `e` | Open in your configured editor |
| `dk finder [path]` | `f` | Open in Finder |
| `dk remote [path]` | `g` | Open git remote in browser |
| `dk open [path]` | `o` | Open in DevKeepr app |

### Interactive

| Command | Alias | Description |
|---------|:-----:|-------------|
| `dk logs [path]` | `L` | Browse and tail a log file |
| `dk actions [path]` | `a` | Browse and run a stack action |