# Meet Devkeepr

Devkeepr brings your projects, their actions, and the work running inside them into one place. Detection figures out what each project can do. Surfaces put those actions a keystroke away wherever you are. The Process Window holds onto whatever you started, attached to the project that owns it.

## Adding Projects

Before any of this works, Devkeepr needs to know where your projects live. Open Projects → settings to add them.

![Project discovery settings showing auto-detected sources and directory entries](/screenshots/docs/project-discovery-settings.webp)

A few ways to feed the list:

- **Auto-detected Herd and Valet sites.** Already running Herd or Valet? Configured sites get picked up automatically.
- **Individual directories.** Point at a single project folder.
- **Parked directories.** Point at a parent folder like `~/code` or `~/Sites`, and every subdirectory becomes a tracked project.

[**Pro**](/pricing) subscribers can manage projects from the terminal with the `dk` CLI using `dk link` or `dk park`. See `dk` [commands reference](/docs/cli-tool/getting-started/commands#project-management) for the full set.

## The Overview

Devkeepr opens to the Overview. Projects sorted by recent activity or size, with indicators for processes, CI status, and deployments. Alongside the project list: disk space reclaimed through hibernation, Claude session stats (Pro), and your global packages.

![The Devkeepr Overview panel](/screenshots/homepage-light.webp)

## The Process Window

If the Overview shows your projects at rest, the Process Window shows them in motion: dev servers, test watchers, agents mid-conversation, builds, CI runs. Everything you start lands here, attached to its project. Same row layout, same status dots, no matter how you triggered it.

Terminals, agents, and scripts you've added to a project stick around. Close the app, reboot, come back tomorrow, and your working set is waiting where you left it. Hit play and you're spun up in seconds.

![Process Window with running projects grouped in the sidebar](/screenshots/docs/getting-started.png)

Full breakdown on the [Process Window](/docs/general/features/processes) page.

## Everything Starts With Stack Detection

The actions available for a project come from [Stack Detection](/docs/general/features/stack-detection). A Laravel + Node project surfaces Artisan commands, Composer scripts, npm scripts, Make targets, GitHub workflow dispatches, GitLab pipeline dispatches, and anything else the matched detectors contribute.

Nothing to configure. Detection runs automatically; available actions reflect what was found.

## The Quick Action Menu

A context menu showing the current project's full set of actions. It surfaces wherever a project appears: rows on the Overview, the Process Window sidebar, the project detail page. Click the `···` button to open it, or reach the same set of actions through the menu bar app or the `dk` [CLI](/docs/general/features/cli-tool).

Contents depend on what was detected:

- **General actions** for every project: open in editor, terminal, Finder, Git remote, hibernate, wake, rescan, copy path, new Terminal, new Agent, pin or unpin.
- **Stack actions** from detected stacks: npm scripts, Composer scripts, Artisan commands, Make targets, Docker compose, GitHub workflow dispatch, GitLab pipeline dispatch, and more.
- **Logs** detected per stack. Pick one to tail it live.
- **New Terminal** and **New Agent** spawn a process attached to the project. The agent submenu picks the adapter: Claude Code, Codex, Cursor Agent, Gemini, Amp, opencode, Aider.

## Reach It From Anywhere

Every surface in Devkeepr exposes the same actions, adapted to its environment.

### Menu Bar

Right-click the tray icon to open the menu. Pinned projects appear as submenus with their full action set. Navigation items have `Option`-key hotkeys. A **Prevent Sleep** toggle (`Option+Z`) keeps your Mac awake through a long build or agent run without leaving the menu.

<p style="text-align: center;">
  <img src="/screenshots/docs/menubar-action-menu.webp" alt="Menu bar action menu with project submenus, agent shortcuts, and a log file picker open" style="max-width: 600px; width: 100%; margin: 1.5rem auto 0; border-radius: 12px;">
</p>

### In The App

Press `Cmd+K` to open the command palette. Searchable, context-aware, current project's actions first.

![Command palette showing project actions and stack scripts](/screenshots/docs/command-palette.webp)

### Project Detail

The project detail screen surfaces all actions directly: stack actions, logs, processes, agents, general actions. No command palette needed.

![Project detail screen showing stack actions and log files](/screenshots/docs/project-detail.webp)

### CLI

The `dk` command brings the same actions to your terminal. See [CLI Tool](/docs/general/features/cli-tool).

![The dk CLI action menu in the terminal](/screenshots/docs/dk-cli.webp)

## What Ties It Together

It's everything about and around the projects on your local machine, in one app. Git sync. Hibernation for the ones sitting idle. Scripts, logs, and CI runs surfaced together. Built-in terminals that stick to their project across reboots. Agent shortcuts that resume the conversation. Deployments tracked in-app.

Devkeepr knows your projects, knows what they use, and gives it all a single home. Everything that lives on your machine, in one app made for it.