devsess
0.6.0
Minor Changes
- 9727233: Add
devsess listto show project presets without starting the daemon, and shell completion forstartpresets. - 9727233: Describe commands and options in
--helpand adddevsess docs, with the CLI reference split into topics readable throughdevsess docs read <id>. - 9727233: Add the
devsessCLI, which starts project presets as detached per-worktree service groups under a per-user daemon and lets you attach to, tail (the last 10 lines by default, optionally following), and stop them. - 9727233: Select runs and services with interactive pickers (type-to-filter,
Ctrl-N/Ctrl-P, and recent presets first in the start picker) or by run ID and qualified selectors;-sis short for--service. - 9727233: Add
devsess statusto inspect active runs without starting the daemon, showing service URLs, ports, in-process services, and memory, with-afor every run in full and, when nothing is running, a summary of the last finished run. - 9727233: Add
devsess daemon start,stop,status,restart,install, anduninstall; on macOS the daemon runs as a launchd job. - 9727233: Store service logs in ~/Library/Logs/devsess on macOS unless XDG_STATE_HOME is set, and show the logs directory in daemon status.
- 9727233: Show
publishRunningreadiness and URLs indevsess status, and let presets wait for it withawaitPublish. - 9727233: Add
devsess restartanddevsess stop --serviceto restart or stop individual services without ending the run.
Patch Changes
- 9727233: A daemon that finds another one already serving the socket now exits 0 instead of being relaunched by launchd forever, no longer deletes that daemon’s socket, and its
pscalls get 3 s instead of 500 ms before failing. - 9727233:
daemon stopandrestartwait for the daemon process to exit before reporting it stopped, a freshly launched daemon gets 15 s to answer, and connect errors other than a missing daemon are reported with their errno. - 9727233: Daemon re-binds its socket if the file is removed, exits cleanly if another process takes the path, and timestamps and explains its startup failures.
- 9727233: Recover from a live daemon whose socket file was unlinked: the CLI waits for it to re-bind, otherwise terminates and relaunches it, and
daemon stop/restartnow reach it.
0.5.0
Minor Changes
- fc74014: Add schema-backed shared services with automatic definition lookup, detached hosts, and cross-process leases in a fixed worktree-root session.
Patch Changes
- 3d6afed: Report scoped services and their ports to the daemon on startup and retract them on scope close.
0.4.0
Minor Changes
- 8827ca8: Require drizzle-orm ^1.0.0-rc.5-5935859 for the optional PGlite adapter.
- 1c7bda1: Add custom handler and Docker-backed services with per-session ports, persistent data directories, scoped cleanup, and layer-based composition.
- 8827ca8: Require stable Effect ^4.0.0; update caller imports from effect/unstable/cli and effect/unstable/process to effect/cli and effect/process.
- f6fcc4c: Upgrade the PGlite adapter to Drizzle v1 RC; consumers must use
drizzle-orm@^1.0.0-rc.4and upgrade existing migrations folders with v1 RCdrizzle-kit up.
Patch Changes
- 3c975ab: Publish PGlite dumps atomically so parallel test workers can safely share a dump path.
- bb61a8b: Avoid reporting a stop failure when a managed subprocess has already exited.
0.3.4
Patch Changes
- 12780a3:
prepareSessionPglitenow closes its PGlite connection and returns onlydataDiranddumpPath; useopenLitePglitefor an in-process client.
0.3.3
Patch Changes
- 32a1553:
publishRunningnow waits up to 5 s for the devsess daemon to acknowledge readiness, instead of silently dropping it after 200 ms when the daemon is busy.
0.3.2
Patch Changes
- bb584ac: Keep managed subprocesses in the caller’s process group so supervisors can stop them together.
0.3.1
Patch Changes
- bfa9886: Publish and clear scoped readiness in a local devsess daemon when service identity is available.
0.3.0
Minor Changes
- 24b3950:
getStickyPortnow accepts an optional{ name }to remember multiple ports per session, keyed by name (defaulting todefault).
0.2.0
Minor Changes
-
33ac04e: Breaking. The Effect API no longer wraps
effect/unstable/cli.devsessexports services, layers, and free functions; you write a stockCommand.make(...)yourself.defineDevCliand theclire-export are gone fromdevsess—devsess/asynckeeps both.Install a platform package yourself.
@effect/platform-nodeis no longer a peer dependency. Add@effect/platform-nodeor@effect/platform-bunand provide itsNodeServices.layer/BunServices.layer.Before:
import { join } from "node:path"; import { NodeRuntime, NodeServices } from "@effect/platform-node"; import { defineDevCli } from "devsess"; import { Effect } from "effect"; const main = defineDevCli({ name: "web", dir: join(import.meta.dirname, ".."), platform: { services: NodeServices.layer, runMain: NodeRuntime.runMain }, run: (ctx) => Effect.gen(function* () { const session = yield* ctx.session; const port = yield* ctx.getStickyPort(); yield* ctx.runManagedSubprocess("bunx", ["vite"], { env: { PORT: String(port) }, }); }), }); main(process.argv);After:
import { NodeRuntime, NodeServices } from "@effect/platform-node"; import { CurrentSession, DevSessions, getStickyPort, runManagedSubprocess, } from "devsess"; import { Effect } from "effect"; import { Command } from "effect/unstable/cli"; const web = Command.make("web", {}, () => Effect.gen(function* () { const session = yield* CurrentSession; const port = yield* getStickyPort(session); yield* runManagedSubprocess("bunx", ["vite"], { env: { PORT: String(port) }, }); }).pipe(Effect.provide(CurrentSession.layer)) ); Command.run(web, { version: "0.1.0" }).pipe( Effect.provide(DevSessions.layer), Effect.provide(NodeServices.layer), Effect.scoped, NodeRuntime.runMain );Migration notes:
diris gone.DevSessions.layerauto-detects the project root — the nearest ancestor ofprocess.cwd()with apackage.json— or fails withProjectRootNotFoundError. UseDevSessions.layerAt(rootDir)to pass one explicitly.- Provide
CurrentSession.layeraround the handler, not aroundCommand.run. A layer’s build effect runs the moment it’s provided, so wrapping the whole CLI would create a session for--helpand--versiontoo. - The
ctxmembers are free functions ondevsess:getStickyPort,runManagedSubprocess,publishRunning,awaitRunning. OnlygetStickyPort(andprepareSessionPglite) take aDevSession. Effect.scopedis yours now. It used to be internal todefineDevCli, and it’s what lets managed subprocesses and running-signal files clean up on exit.--versionis real, rather than the hardcoded0.0.0the old scaffolding reported.createDevSessions(rootDir, services)takes a bare project root, matchingDevSessions.layerAt; both resolve to<rootDir>/.data/sessions. Stop pre-joining.data/sessions— passing the old path doubles it up and orphans existing sessions.
0.1.0
Minor Changes
- d7282b1: Initial release: Effect-based dev-session scaffolding (
defineDevCli) with persistent sessions, sticky ports, managed subprocesses, and cross-service running signals; a per-session PGlite + Drizzle adapter atdevsess/pglite; and a plain-async facade atdevsess/asyncfor scripts that prefer Promises over Effect.