localdeck 1.6.2 → 1.7.1

package/CHANGELOG.md

@@ -1,5 +1,26 @@
 # Changelog
 
+## 1.7.1 — Background workers become ready
+
+### Fixed
+
+- Let background workers that never open their port pass a command readiness check. The check used to wait for a listener that never came, so the service stayed on Checking readiness and was stopped after the 60-second timeout.
+- Show such a worker as Ready once its check passes, without Waiting for listener, and count it as running in the project status.
+
+## 1.7.0 — LocalDeck in Quarry
+
+### Added
+
+- Show and control a project's services in Quarry with the new localdeck quarry command. It speaks the Quarry Extension Protocol over stdio: Quarry lists services, starts, stops and restarts them, follows their logs, and opens the project's dashboard page. LocalDeck keeps running the services, so they match the dashboard and keep running when Quarry closes.
+- Opening a Quarry workspace finds its remembered project, or remembers the folder's .localdeck the way localdeck commands does. Connecting never starts services.
+- Share a service from Quarry with a password-protected link; the password is shown once. Services started in a terminal still have to be restarted there.
+- Give Quarry's agents six MCP tools (list_services, get_service, get_logs, start_service, stop_service and restart_service), limited to the workspace's project.
+- Ship the Quarry manifest, quarry-extension.json, in the repository and the npm package. See docs/quarry.md.
+
+### Changed
+
+- Ship the command-line and daemon bundles minified.
+
 ## 1.6.2 — Steady project header menus
 
 ### Fixed

package/README.md

@@ -2,7 +2,7 @@
 
 **One place to run, inspect, and share your local development services.**
 
-LocalDeck runs the commands your project already uses, gives web services stable local addresses, and brings their controls and logs into a browser dashboard. Use it for a single app or a monorepo with frontends, APIs, and database dependencies.
+LocalDeck runs the commands your project already uses, gives web services stable local addresses, and brings their controls and logs into a browser dashboard. Use it for a single app or a monorepo with frontends, APIs, and database dependencies. Maintained by [jus-ta-dev](https://github.com/jus-ta-dev).
 
 ## Install
 
@@ -30,19 +30,20 @@ In another terminal:
 localdeck open             # Open the dashboard
 ```
 
-The dashboard is served at `http://localhost:7777` by default. It remembers projects registered through the CLI. You can start and stop individual services, open local and shared links, and follow selected services in a resizable logs panel.
+The dashboard is served at `http://localhost:7777` by default. It remembers projects registered through the CLI. You can start and stop individual services, open local and shared links, and inspect logs and requests on service pages or in a resizable panel.
 
 `localdeck up` runs in the foreground: **Ctrl-C stops the services it owns**. Services started from the dashboard continue in the background until you stop them or shut down the daemon.
 
 ## What you get
 
 - **Stable addresses:** keep a consistent local port even when the development server chooses another upstream port.
-- **Project controls:** start one service or a whole project, with dependencies started in order and checked for readiness.
+- **Project and service pages:** start services in dependency order, inspect each service's Logs, Requests, and Config tabs, and see when a running service needs a restart to apply changed settings.
+- **Stackable profiles:** change a service's command, working directory, environment, or secrets for setups such as staging and debugging while keeping its name and stable address.
 - **Clean URLs:** optional addresses such as `http://platform.web.localhost`, with a project nickname and port-80 forwarding enabled.
-- **Project secrets:** store values outside your project and pass them to services as environment variables. Manage them from the Secrets button in the project dashboard.
-- **Combined logs:** select multiple services, switch between their tabs, filter output, and choose a display limit from 100 to 5,000 lines.
-- **Command palette:** press ⌘K / Ctrl+K or choose Search commands to find projects, open apps and logs, and start, stop, or restart services.
-- **HTTPS sharing:** create temporary Cloudflare links with optional password protection, pending status, and shared-request logs.
+- **Project secrets:** store values outside your project and pass them to services as environment variables. Manage them in the project's Secrets tab.
+- **Logs and requests panel:** watch multiple services from the bottom bar, filter retained output, and choose a log display limit from 100 to 5,000 lines.
+- **Command palette:** press ⌘K / Ctrl+K or choose Search in the sidebar to find projects, open apps and logs, and start, stop, or restart services.
+- **HTTPS sharing:** create temporary Cloudflare links protected by a generated password by default, with pending status and shared-request logs.
 - **Coding-agent access:** an MCP server for service inspection, controls, diagnostics data, and recorded GET/HEAD replay.
 - **Activity and comparisons:** inspect a unified incident timeline and mark a baseline to see what changed.
 - **Worktree environments:** discover existing Git worktrees and switch between separately registered service environments.
@@ -78,11 +79,28 @@ LocalDeck supplies `PORT` and expands `{port}` to the application's upstream por
 
 For scripts such as `wrangler dev --port ${API_PORT:-8787}`, LocalDeck also supplies the assigned port through `API_PORT`, without editing your project. It follows individual npm, pnpm, Yarn and Bun scripts, including npm workspace selectors and package directory options. Explicit service `env` settings and secrets take precedence over inferred variables. Complex shell commands and hardcoded ports continue to use normal socket detection.
 
-See configuration (included as `docs/configuration.md`) for working directories, profiles, environment references, database services, and advanced readiness checks.
+See configuration (included as `docs/configuration.md`) for working directories, profiles, environment references, database services, background workers, and advanced readiness checks.
+
+## Switch profiles
+
+Define profiles in `.localdeck` to change how existing services run. For example, a `staging` profile can give `web` a different API URL without changing its name, dependencies, or stable port:
+
+```json
+{
+  "commands": [{ "name": "web", "run": "npm run dev" }],
+  "profiles": {
+    "staging": {
+      "services": { "web": { "env": { "API_URL": "https://api.staging.example.com" } } }
+    }
+  }
+}
+```
+
+Run `localdeck profile on staging` or use the **Profiles** menu on the project page. You can turn on several profiles; they apply in file order, with the later profile winning when settings overlap. The selection is saved only on your computer. Switching profiles does not start or restart services, so restart a running service to apply its new settings. Open the service's **Config** tab to see the resolved command, directory, environment, and secret names. See profiles (included as `docs/configuration.md`) for the available overrides.
 
 ## Inspect requests
 
-Open **Options → View requests** for a service. Expand a row to inspect headers, cookies, the request body, and the response. Successful assets and development modules are hidden by default. Each service tab has its own clear control for requests and logs.
+Open a service's **Requests** tab, or use the bottom **Requests** panel to watch several services. Expand a row to inspect headers, cookies, the request body, and the response. Successful assets and development modules are hidden by default. Service pages also have **Logs** and **Config** tabs.
 
 Capture works only through LocalDeck's service URLs. A frontend calling Wrangler directly at `http://localhost:8787`, or through a Worker service binding, bypasses the proxy. Set your app's API base URL to the API service's LocalDeck URL to capture that traffic.
 
@@ -93,7 +111,8 @@ Responses load on demand from a 64 MiB shared cache. Older bodies are evicted as
 | Command | Purpose |
 | --- | --- |
 | `localdeck web` | Start the configured web service and its prerequisites. |
-| `localdeck profile on staging` | Run services differently, for example against staging, without renaming them. |
+| `localdeck profile on staging` | Select the staging overrides for the next service start or restart. |
+| `localdeck profile off staging` | Turn off a profile without stopping running services. |
 | `localdeck ps` | List service states, ports, and URLs. |
 | `localdeck logs web -f` | Follow a service's output. |
 | `localdeck requests web` | Inspect recent proxied requests. |
@@ -114,7 +133,7 @@ cloudflared --version
 localdeck share web
 ```
 
-The CLI generates a password by default. Use `--password <password>` to choose one, or `--public` for an unprotected link. In the dashboard, choose **Share**, enter an optional password, and submit. A blank dashboard password creates an unprotected share.
+The CLI generates a password by default. Use `--password <password>` to choose one, or `--public` for an unprotected link. In the dashboard, choose **Share…** from the service's options menu. Leaving the password blank generates one; select **Public link** explicitly to create an unprotected share.
 
 The generated URL appears beside a spinner while LocalDeck checks connectivity. After one minute, the dashboard suggests opening the link yourself; a request reaching the public tunnel also confirms connectivity. Startup ends after two minutes if the link still cannot be verified. Pending and failed states survive a dashboard refresh. Protected links have a masked password with **Show/Hide**.
 
@@ -122,7 +141,7 @@ Quick Tunnel URLs are temporary and may have DNS delays. They stop when the serv
 
 ## Clean URLs and networking
 
-Enable **Clean URLs** in Settings, or use the prompt above the dashboard footer. LocalDeck verifies forwarding before removing the port from links. Setup may request administrator approval on macOS or Windows. If forwarding is unavailable, the original port-number URLs remain usable.
+Enable **Clean URLs** in Settings, or use the notice at the bottom of the sidebar. LocalDeck verifies forwarding before removing the port from links. Setup may request administrator approval on macOS or Windows. If forwarding is unavailable, the original port-number URLs remain usable.
 
 CORS still belongs to your application. `http://localhost:3001`, `http://platform.web.localhost`, and a public HTTPS tunnel URL are different browser origins. Add the frontend origin you actually visit to your API's allowlist. LocalDeck does not rewrite CORS policies or application API URLs.
 
@@ -165,6 +184,7 @@ Use `localdeck mcp --project <id>` to restrict access to one remembered project.
 - CLI reference (included as `docs/commands.md`)
 - Dashboard and platform support (included as `docs/dashboard.md`)
 - MCP integration (included as `docs/mcp.md`)
+- Quarry extension (included as `docs/quarry.md`)
 - Changelog (included as `CHANGELOG.md`)
 
 ## License