Projects

The Projects view is a local development project runner built into the desktop app. It discovers the runnable commands in your codebase, lets you launch and monitor them from a single interface, and connects running dev servers directly to the crawler and security scanner — so you can inspect a local build without leaving the tool that will audit it.

The view is arranged in three panels. The left panel lists every project in the active workspace. The centre panel shows the commands available for the selected project. The right panel displays live terminal output from the running process, including exit codes when a command finishes.

Adding projects

Add a project by clicking the Add project button in the project list. A system folder picker dialog opens so you can navigate to the project root. You can also type or paste an absolute path directly into the path input field if you prefer.

Projects are scoped to the active workspace. Switching workspaces shows a different set of projects, and adding a project registers it only in the workspace you are currently in. This keeps unrelated codebases separated when you organise work across multiple workspaces.

Once added, the project appears in the left panel and its commands are discovered automatically. Removing a project from the list does not alter the project's files on disk.

Commands

When you select a project, Consuela scans the project directory for recognised task files and extracts every runnable command it finds. Three sources are supported:

Source file	What is discovered
`package.json`	Every entry in the `scripts` object — `dev`, `build`, `test`, and any custom scripts you have defined.
`Cargo.toml`	Binary and example targets. Each appears as a runnable command with its target name.
`Makefile`	Targets defined in the Makefile. Phony and file targets are both listed.

Commands are grouped by their source file in the centre panel, so a project that has both a package.json and a Makefile shows two labelled sections. Discovery runs again each time you select the project, so newly added scripts or targets appear without a manual refresh.

Running

Click a command to run it. The right panel opens a live terminal view that streams the process output as it arrives. Standard output and standard error are interleaved in the order the process produces them.

While a command is running, the toolbar shows a Stop button that sends a termination signal to the process. When the process exits — on its own or because you stopped it — the terminal displays the exit code at the bottom of the output. A zero exit code indicates success; anything else indicates an error.

You can run one command at a time per project. Clicking a different command while one is already running will stop the current process before starting the new one. The terminal output from the previous run is replaced by the new output.

Quick actions

When a running process emits a localhost URL in its output — for example http://localhost:9102 from a dev server — Consuela detects it and displays quick-action buttons above the terminal output. The detected URL is shown alongside the buttons and can be edited if the auto-detected address is not the one you want to target.

Three quick actions are available:

Action	What it does
Crawl	Sends the detected URL to the crawler and opens the crawl view. This is the fastest path from starting a dev server to auditing the site it serves.
URL security scan	Runs a security scan against the detected URL, inspecting response headers, TLS configuration, and common misconfigurations for the running server.
Directory security scan	Runs a security scan against the project directory on disk, checking for exposed secrets, insecure file permissions, and other file-level findings.

Quick actions only appear while the process is running. Stopping the process hides them. If the process outputs more than one URL, the most recently detected one is shown, but you can overwrite it with any address before triggering an action.