CLI (cac)

npm install devframe cac

import { defineDevframe } from 'devframe'
import { createCac } from 'devframe/adapters/cac'

const myDevframe = defineDevframe({
  id: 'my-tool',
  name: 'My Tool',
  clientAssets: './client/dist',
  setup(ctx) { /* register docks, RPC, etc. */ },
})

await createCac(myDevframe).parse()

my-tool                         # dev server at http://localhost:9999/
my-tool --port 8080
my-tool build --out-dir dist-static
my-tool build --out-dir dist-static --base /my-tool/
my-tool mcp                     # stdio MCP server

interface CacHandle {
  cli: CAC // raw cac instance — mutate before calling parse()
  parse: (argv?: string[]) => Promise<void>
}

defineDevframe({
  id: 'my-tool',
  clientAssets: './client/dist', // built SPA served as the UI
  cli: {
    command: 'mytool', // binary name; default: the id
    port: 7777, // preferred port
    portRange: [7777, 9000], // passed through to get-port-please
    random: false, // passed through to get-port-please
    host: '127.0.0.1', // default bind host; --host overrides
    open: true, // auto-open the browser on dev start; embeds the current OTP so the tab lands authenticated
    configure(cli) { // contribute capability flags/commands
      cli.option('--config <file>', 'Custom config file')
        .option('--no-files', 'Skip file matching')
    },
  },
  setup(ctx, { flags }) {
    // `flags` is the parsed cac flag bag — includes both devframe's
    // built-ins (`--port`, `--host`, `--open`) and anything declared in
    // `cli.configure` or `configureCli`.
  },
})

await createCac(myDevframe, {
  onReady({ origin }) {
    console.log(`ESLint Config Inspector ready at ${origin}`)
  },
}).parse()