{"_id":"@agent-dev-lab/cli","_rev":"9-f63bd368582aabe2ecf5088d78f1e2b0","name":"@agent-dev-lab/cli","dist-tags":{"latest":"0.0.7"},"versions":{"0.0.3":{"name":"@agent-dev-lab/cli","version":"0.0.3","keywords":["cli","adl","agents","workflows"],"author":{"name":"J. Simon Richard"},"license":"MIT","_id":"@agent-dev-lab/cli@0.0.3","maintainers":[{"name":"jsimonrichard","email":"jsimonrichard@gmail.com"}],"homepage":"https://github.com/jsimonrichard/agent-dev-lab#readme","bugs":{"url":"https://github.com/jsimonrichard/agent-dev-lab/issues"},"bin":{"adl":"dist/cli.js"},"dist":{"shasum":"3bcb9e108cf1c381f153f19caebd0fe083c3ee1c","tarball":"https://registry.npmjs.org/@agent-dev-lab/cli/-/cli-0.0.3.tgz","fileCount":22,"integrity":"sha512-EJJX0UYUUcW1XtR0TVlxHs82EKCLG74h/D++0s4lPDRS3h6Ddh9fhwrujnJUqT+9LS1PSetTb0yOvs9/900jDA==","signatures":[{"sig":"MEUCIQDLjYJ8/nMxtINjRwZmUSkOJp3E0cGlwGvaii/CGqybgwIgH2emi8BBWanmU3vmsjm/BXJEo1iNaCIEvVxqH3z2sJg=","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"attestations":{"url":"https://registry.npmjs.org/-/npm/v1/attestations/@agent-dev-lab%2fcli@0.0.3","provenance":{"predicateType":"https://slsa.dev/provenance/v1"}},"unpackedSize":35177},"tsup":{"clean":true,"entry":["src/bin/cli.ts"],"format":["esm"],"minify":false,"target":"node22","external":["@agent-dev-lab/core","@agent-dev-lab/core/project"],"tsconfig":"tsconfig.json","splitting":true},"type":"module","_from":"file:/tmp/agent-dev-lab-cli-0.0.3.tgz","engines":{"node":">=22"},"private":false,"scripts":{"dev":"bun run src/bin/cli.ts","lint":"eslint .","test":"bun test src","build":"tsup --silent && bun run package-scaffold","prebuild":"bun run verify:web-output && tsc -p tsconfig.json --noEmit","test:e2e":"bun test src/e2e","typecheck":"tsc -p tsconfig.json --noEmit","ci:publish":"bash ../../scripts/ci-publish.sh","package-scaffold":"bun run scripts/package-scaffold.ts","verify:web-output":"bun run scripts/verify-web-output.ts"},"_npmUser":{"name":"GitHub Actions","email":"npm-oidc-no-reply@github.com","trustedPublisher":{"id":"github","oidcConfigId":"oidc:3398b6ad-d87c-4206-81ae-6ff7fbf6c7ce"}},"_resolved":"/tmp/agent-dev-lab-cli-0.0.3.tgz","_integrity":"sha512-EJJX0UYUUcW1XtR0TVlxHs82EKCLG74h/D++0s4lPDRS3h6Ddh9fhwrujnJUqT+9LS1PSetTb0yOvs9/900jDA==","repository":{"url":"git+https://github.com/jsimonrichard/agent-dev-lab.git","type":"git","directory":"apps/cli"},"_npmVersion":"12.0.2","description":"Agent Development Lab command-line interface","directories":{},"_nodeVersion":"22.23.2","dependencies":{"@stricli/core":"^1.2.7","@agent-dev-lab/web":"0.0.3","@agent-dev-lab/core":"0.0.3"},"publishConfig":{"access":"public"},"_hasShrinkwrap":false,"_npmOperationalInternal":{"tmp":"tmp/cli_0.0.3_1788196574793_0.10486345636794803","host":"s3://npm-registry-packages-npm-production"}},"0.0.4":{"name":"@agent-dev-lab/cli","version":"0.0.4","keywords":["cli","adl","agents","workflows"],"author":{"name":"J. Simon Richard"},"license":"MIT","_id":"@agent-dev-lab/cli@0.0.4","maintainers":[{"name":"jsimonrichard","email":"jsimonrichard@gmail.com"}],"homepage":"https://github.com/jsimonrichard/agent-dev-lab#readme","bugs":{"url":"https://github.com/jsimonrichard/agent-dev-lab/issues"},"bin":{"adl":"dist/cli.js"},"dist":{"shasum":"c096e0f4180ce2f02256c50957c4134b934b4a27","tarball":"https://registry.npmjs.org/@agent-dev-lab/cli/-/cli-0.0.4.tgz","fileCount":23,"integrity":"sha512-MCOEOIpr7MCvfaS9U4LHDrycXjrvetz3NODVsAvEi0GbUUxwcaZ+GIFfp8uy0cDndAr2Yv3p6E9G7y4l0Y9eog==","signatures":[{"sig":"MEUCIQD9S/+7Y2AaT29UZz1ET83FLWTdoSTq4LvH9x1R/e4Y4wIgOKDjn8yhWjc34Ed8lhgloFY3vI/fvHx6d7Zskj/4hk4=","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"attestations":{"url":"https://registry.npmjs.org/-/npm/v1/attestations/@agent-dev-lab%2fcli@0.0.4","provenance":{"predicateType":"https://slsa.dev/provenance/v1"}},"unpackedSize":35373},"tsup":{"clean":true,"entry":["src/bin/cli.ts"],"format":["esm"],"minify":false,"target":"node22","external":["@agent-dev-lab/core","@agent-dev-lab/core/project"],"tsconfig":"tsconfig.json","splitting":true},"type":"module","_from":"file:/tmp/agent-dev-lab-cli-0.0.4.tgz","engines":{"node":">=22"},"private":false,"scripts":{"dev":"bun run src/bin/cli.ts","lint":"eslint .","test":"bun test src","build":"tsup --silent && bun run package-scaffold","prebuild":"bun run verify:web-output && tsc -p tsconfig.json --noEmit","test:e2e":"bun test src/e2e","typecheck":"tsc -p tsconfig.json --noEmit","ci:publish":"bash ../../scripts/ci-publish.sh","package-scaffold":"bun run scripts/package-scaffold.ts","verify:web-output":"bun run scripts/verify-web-output.ts"},"_npmUser":{"name":"GitHub Actions","email":"npm-oidc-no-reply@github.com","trustedPublisher":{"id":"github","oidcConfigId":"oidc:3398b6ad-d87c-4206-81ae-6ff7fbf6c7ce"}},"_resolved":"/tmp/agent-dev-lab-cli-0.0.4.tgz","_integrity":"sha512-MCOEOIpr7MCvfaS9U4LHDrycXjrvetz3NODVsAvEi0GbUUxwcaZ+GIFfp8uy0cDndAr2Yv3p6E9G7y4l0Y9eog==","repository":{"url":"git+https://github.com/jsimonrichard/agent-dev-lab.git","type":"git","directory":"apps/cli"},"_npmVersion":"12.0.2","description":"Agent Development Lab command-line interface","directories":{},"_nodeVersion":"22.23.2","dependencies":{"@stricli/core":"^1.2.7","@agent-dev-lab/web":"0.0.3","@agent-dev-lab/core":"0.0.3"},"publishConfig":{"access":"public"},"_hasShrinkwrap":false,"_npmOperationalInternal":{"tmp":"tmp/cli_0.0.4_1788200751737_0.1030100201441353","host":"s3://npm-registry-packages-npm-production"}},"0.0.5":{"name":"@agent-dev-lab/cli","version":"0.0.5","keywords":["cli","adl","agents","workflows"],"author":{"name":"J. Simon Richard"},"license":"MIT","_id":"@agent-dev-lab/cli@0.0.5","maintainers":[{"name":"jsimonrichard","email":"jsimonrichard@gmail.com"}],"homepage":"https://github.com/jsimonrichard/agent-dev-lab#readme","bugs":{"url":"https://github.com/jsimonrichard/agent-dev-lab/issues"},"bin":{"adl":"dist/cli.js"},"dist":{"shasum":"1b787faa1b539c3d9ab8eece8a61d382b0fa2b52","tarball":"https://registry.npmjs.org/@agent-dev-lab/cli/-/cli-0.0.5.tgz","fileCount":23,"integrity":"sha512-UYbi9fsFpmk92ekSSQdf9WnHkWVphkRbVMvM5i5bn9k34pcmIG/CJ95xC5r86r28pl4JINiGZGinnIOmf4RDRQ==","signatures":[{"sig":"MEQCID4jkMQIm9nj7KFemvPS/0lFLJKs7f6+sQDJo3wkbjnhAiBr5rwiCRrGb1mW34GkLw+QCZJvrRIQocNsVC11Pz2urA==","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"attestations":{"url":"https://registry.npmjs.org/-/npm/v1/attestations/@agent-dev-lab%2fcli@0.0.5","provenance":{"predicateType":"https://slsa.dev/provenance/v1"}},"unpackedSize":35665},"tsup":{"clean":true,"entry":["src/bin/cli.ts"],"format":["esm"],"minify":false,"target":"node22","external":["@agent-dev-lab/core","@agent-dev-lab/core/project"],"tsconfig":"tsconfig.json","splitting":true},"type":"module","_from":"file:/tmp/agent-dev-lab-cli-0.0.5.tgz","engines":{"node":">=22"},"private":false,"scripts":{"dev":"bun run src/bin/cli.ts","lint":"eslint .","test":"bun test src","build":"tsup --silent && bun run package-scaffold","prebuild":"bun run verify:web-output && tsc -p tsconfig.json --noEmit","test:e2e":"bun test src/e2e","typecheck":"tsc -p tsconfig.json --noEmit","ci:publish":"bash ../../scripts/ci-publish.sh","package-scaffold":"bun run scripts/package-scaffold.ts","verify:web-output":"bun run scripts/verify-web-output.ts"},"_npmUser":{"name":"GitHub Actions","email":"npm-oidc-no-reply@github.com","trustedPublisher":{"id":"github","oidcConfigId":"oidc:3398b6ad-d87c-4206-81ae-6ff7fbf6c7ce"}},"_resolved":"/tmp/agent-dev-lab-cli-0.0.5.tgz","_integrity":"sha512-UYbi9fsFpmk92ekSSQdf9WnHkWVphkRbVMvM5i5bn9k34pcmIG/CJ95xC5r86r28pl4JINiGZGinnIOmf4RDRQ==","repository":{"url":"git+https://github.com/jsimonrichard/agent-dev-lab.git","type":"git","directory":"apps/cli"},"_npmVersion":"12.0.2","description":"Agent Development Lab command-line interface","directories":{},"_nodeVersion":"22.23.2","dependencies":{"@stricli/core":"^1.2.7","@agent-dev-lab/web":"0.0.3","@agent-dev-lab/core":"0.0.3"},"publishConfig":{"access":"public"},"_hasShrinkwrap":false,"_npmOperationalInternal":{"tmp":"tmp/cli_0.0.5_1788201483768_0.9613813648143006","host":"s3://npm-registry-packages-npm-production"}},"0.0.6":{"name":"@agent-dev-lab/cli","version":"0.0.6","keywords":["cli","adl","agents","workflows"],"author":{"name":"J. Simon Richard"},"license":"MIT","_id":"@agent-dev-lab/cli@0.0.6","maintainers":[{"name":"jsimonrichard","email":"jsimonrichard@gmail.com"}],"homepage":"https://github.com/jsimonrichard/agent-dev-lab#readme","bugs":{"url":"https://github.com/jsimonrichard/agent-dev-lab/issues"},"bin":{"adl":"dist/cli.js"},"dist":{"shasum":"f20085ac6ef6725746c004150fcaa4c191641339","tarball":"https://registry.npmjs.org/@agent-dev-lab/cli/-/cli-0.0.6.tgz","fileCount":23,"integrity":"sha512-YCZkSdccBoc3/wrlo+NUgVWvqGQgNi38p9BfLvsKYuYKJkbEomYouAA/dCMTO9o/+HWy9c4uhIGwS5fDfMdYiw==","signatures":[{"sig":"MEUCIQDnKryFjjtsf1ic0AMoLFtwq2/7S6SynsCNa/B3fihNoQIgPt9sX4FtZMLroTUw7C8TVSzRs0Q/C1yXpZBHALfMTgo=","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"attestations":{"url":"https://registry.npmjs.org/-/npm/v1/attestations/@agent-dev-lab%2fcli@0.0.6","provenance":{"predicateType":"https://slsa.dev/provenance/v1"}},"unpackedSize":40362},"tsup":{"clean":true,"entry":["src/bin/cli.ts"],"format":["esm"],"minify":false,"target":"node22","external":["@agent-dev-lab/core","@agent-dev-lab/core/project"],"tsconfig":"tsconfig.json","splitting":true},"type":"module","_from":"file:/tmp/agent-dev-lab-cli-0.0.6.tgz","engines":{"node":">=22"},"private":false,"scripts":{"dev":"bun run src/bin/cli.ts","lint":"eslint .","test":"bun test src","build":"tsup --silent && bun run package-scaffold","prebuild":"bun run verify:web-output && tsc -p tsconfig.json --noEmit","test:e2e":"bun test src/e2e","typecheck":"tsc -p tsconfig.json --noEmit","ci:publish":"bash ../../scripts/ci-publish.sh","package-scaffold":"bun run scripts/package-scaffold.ts","verify:web-output":"bun run scripts/verify-web-output.ts"},"_npmUser":{"name":"GitHub Actions","email":"npm-oidc-no-reply@github.com","trustedPublisher":{"id":"github","oidcConfigId":"oidc:3398b6ad-d87c-4206-81ae-6ff7fbf6c7ce"}},"_resolved":"/tmp/agent-dev-lab-cli-0.0.6.tgz","_integrity":"sha512-YCZkSdccBoc3/wrlo+NUgVWvqGQgNi38p9BfLvsKYuYKJkbEomYouAA/dCMTO9o/+HWy9c4uhIGwS5fDfMdYiw==","repository":{"url":"git+https://github.com/jsimonrichard/agent-dev-lab.git","type":"git","directory":"apps/cli"},"_npmVersion":"12.0.2","description":"Agent Development Lab command-line interface","directories":{},"_nodeVersion":"22.23.2","dependencies":{"@stricli/core":"^1.2.7","@agent-dev-lab/web":"0.0.4","@agent-dev-lab/core":"0.0.4"},"publishConfig":{"access":"public"},"_hasShrinkwrap":false,"_npmOperationalInternal":{"tmp":"tmp/cli_0.0.6_1789240084195_0.7145205919909208","host":"s3://npm-registry-packages-npm-production"}},"0.0.7":{"name":"@agent-dev-lab/cli","version":"0.0.7","private":false,"license":"MIT","publishConfig":{"access":"public"},"description":"Agent Development Lab command-line interface","type":"module","bin":{"adl":"dist/cli.js"},"scripts":{"dev":"bun run src/bin/cli.ts","prebuild":"bun run verify:web-output && tsc -p tsconfig.json --noEmit","build":"tsup --silent && bun run package-scaffold","package-scaffold":"bun run scripts/package-scaffold.ts","ci:publish":"bash ../../scripts/ci-publish.sh","typecheck":"tsc -p tsconfig.json --noEmit","lint":"eslint .","verify:web-output":"bun run scripts/verify-web-output.ts","test":"bun test src","test:e2e":"bun test src/e2e"},"dependencies":{"@agent-dev-lab/core":"0.0.5","@agent-dev-lab/web":"0.0.5","@stricli/core":"^1.2.7"},"tsup":{"entry":["src/bin/cli.ts"],"format":["esm"],"tsconfig":"tsconfig.json","clean":true,"splitting":true,"minify":false,"target":"node22","external":["@agent-dev-lab/core","@agent-dev-lab/core/project"]},"author":{"name":"J. Simon Richard"},"repository":{"type":"git","url":"git+https://github.com/jsimonrichard/agent-dev-lab.git","directory":"apps/cli"},"bugs":{"url":"https://github.com/jsimonrichard/agent-dev-lab/issues"},"homepage":"https://github.com/jsimonrichard/agent-dev-lab#readme","keywords":["cli","adl","agents","workflows"],"engines":{"node":">=22"},"_id":"@agent-dev-lab/cli@0.0.7","_integrity":"sha512-QVVKc8qXP57vMiouSD270pCWjYoGaZ+gmfvRDuv0ooxa/DSVJPD0PD9/LNO30xLWuqHM463mmFB9PxV7HtQnJQ==","_resolved":"/tmp/agent-dev-lab-cli-0.0.7.tgz","_from":"file:/tmp/agent-dev-lab-cli-0.0.7.tgz","_nodeVersion":"22.23.2","_npmVersion":"12.0.2","dist":{"integrity":"sha512-QVVKc8qXP57vMiouSD270pCWjYoGaZ+gmfvRDuv0ooxa/DSVJPD0PD9/LNO30xLWuqHM463mmFB9PxV7HtQnJQ==","shasum":"fe90d12fe114fb0ca9361d6fd08acf77c5fdbbc7","tarball":"https://registry.npmjs.org/@agent-dev-lab/cli/-/cli-0.0.7.tgz","fileCount":23,"unpackedSize":41472,"attestations":{"url":"https://registry.npmjs.org/-/npm/v1/attestations/@agent-dev-lab%2fcli@0.0.7","provenance":{"predicateType":"https://slsa.dev/provenance/v1"}},"signatures":[{"keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U","sig":"MEYCIQCqDNcfZM3jLfen6Qy5/UlL7GS7ZAe6YbR56tus793JrgIhANeu3QFwM8ArhiWmtw8NNli65v/nOJF/EgznMWXzOq5+"}]},"_npmUser":{"name":"GitHub Actions","email":"npm-oidc-no-reply@github.com","trustedPublisher":{"id":"github","oidcConfigId":"oidc:3398b6ad-d87c-4206-81ae-6ff7fbf6c7ce"}},"directories":{},"maintainers":[{"name":"jsimonrichard","email":"jsimonrichard@gmail.com"}],"_npmOperationalInternal":{"host":"s3://npm-registry-packages-npm-production","tmp":"tmp/cli_0.0.7_1789573362962_0.956398722876834"},"_hasShrinkwrap":false}},"time":{"created":"2026-08-31T16:19:26.667Z","modified":"2026-09-16T15:42:43.540Z","0.0.1":"2026-08-31T16:19:26.965Z","0.0.2":"2026-08-31T17:03:44.011Z","0.0.3":"2026-08-31T17:16:14.925Z","0.0.4":"2026-08-31T18:25:51.872Z","0.0.5":"2026-08-31T18:38:03.912Z","0.0.6":"2026-09-12T19:08:04.328Z","0.0.7":"2026-09-16T15:42:43.091Z"},"bugs":{"url":"https://github.com/jsimonrichard/agent-dev-lab/issues"},"author":{"name":"J. Simon Richard"},"license":"MIT","homepage":"https://github.com/jsimonrichard/agent-dev-lab#readme","keywords":["cli","adl","agents","workflows"],"repository":{"type":"git","url":"git+https://github.com/jsimonrichard/agent-dev-lab.git","directory":"apps/cli"},"description":"Agent Development Lab command-line interface","maintainers":[{"name":"jsimonrichard","email":"jsimonrichard@gmail.com"}],"readme":"<img src=\"https://raw.githubusercontent.com/jsimonrichard/agent-dev-lab/main/assets/brand/logo.svg\" alt=\"\" width=\"40\" height=\"40\" align=\"left\" />\n\n# @agent-dev-lab/cli\n\nThe `adl` CLI for [Agent Dev Lab](https://agent-dev-lab.com) — scaffold a project, run agents and workflows from the terminal, and launch the inspection UI. Type-safe CLI built with [Stricli](https://bloomberg.github.io/stricli/). Runs on **Node 22+** (SQLite via `better-sqlite3`) or **Bun** (SQLite via `bun:sqlite`) — neither is required over the other to use ADL. Bun is the default toolchain for the monorepo and for the scaffold's `dev`/`dashboard` scripts, but `npm` / Node work fine too.\n\n## Usage\n\n```bash\nbunx @agent-dev-lab/cli@latest init my-research\n# or: npx @agent-dev-lab/cli@latest init my-research\ncd my-research\nbun install\n# or: npm install\ncp .env.example .env   # then set OPENAI_API_KEY\nbunx adl workflow run demo-counter --input '{\"steps\":3}'\nbunx adl agent run assistant --input \"What is Agent Dev Lab?\"\nbunx adl dashboard      # inspection UI\n```\n\n`adl init` scaffolds a project depending on `@agent-dev-lab/core` (and `@agent-dev-lab/web` for `adl dashboard`) — this package is not meant to be used standalone without those. After install, `bunx adl`, `npx adl`, or `node_modules/.bin/adl` all work (the `\"bin\"` entry is `adl`, not this package's own name) — `bunx`/`npx` resolve the local `node_modules/.bin` copy first, so no global install is needed.\n\n## Commands\n\n| Command                               | Description                                                                                |\n| ------------------------------------- | ------------------------------------------------------------------------------------------ |\n| `adl init <dir>` (`adl i`)            | Scaffold a new ADL project (no VCS; `--git` / `-g` runs `git init`)                        |\n| `adl workflow run <id> --input '{}'`  | Run a registered workflow (`adl w r`); `--input` / `-i` is JSON                            |\n| `adl workflow list`                   | Print workflow ids (`adl w l`)                                                             |\n| `adl agent list`                      | Print agent ids (`adl a l`); `ToolProvider` agents get `(tool-context)`                    |\n| `adl agent run <id> --input \"…\"`      | Run a registered agent (`adl a r`); `--input` is a string, `--tool-context` / `-c` is JSON |\n| `adl dashboard` (`adl d`, `adl dash`) | Inspection UI for the nearest `adl.config.*`                                               |\n| `adl dashboard --serve` (`-s`)        | Do not reload agents, workflows, or templates from disk                                    |\n| `adl dashboard --project <path>`      | Explicit ADL project root (`-p`; `-P` is `--port`, since `-p` is taken)                    |\n| `adl dashboard --strictPort`          | Fail if `--port` is already bound instead of using the next free port                      |\n\n## Development\n\n```bash\nbun run dev:cli\ncd apps/cli && bun run dev -- workflow list\n```\n\nFramework UI development against `apps/playground` uses `bun run dev:web`. `adl dashboard --prebuilt` uses the shipped UI build from this checkout instead of the live UI source.\n\n`adl init` does not create a Git (or jj) repository. Pass `--git` to run `git init` in the new project. `.gitignore` is still written either way — jj uses it too.\n\nFrom the source checkout, `adl init --local` pins `@agent-dev-lab/*` to this repo with `file:` + `overrides` so a throwaway project can `bun install` without npm. The flag is hidden in published CLI help.\n\n```bash\nbun apps/cli/src/bin/cli.ts init /tmp/my-research --local\n```\n\n## Build\n\n`bun run build` verifies `@agent-dev-lab/web/.output` exists before compiling the CLI.\n\n```bash\nbun run build\n./dist/cli.js --help\n```\n","readmeFilename":"README.md"}