@agenteer/cli

Command-line interface for Agenteer. It runs workflows, resumes suspended sessions, inspects context and traces, and wraps publish/install/search for node packages.

Install

npm install -g @agenteer/cli

Or run without a global install:

npx @agenteer/cli run --spec workflow.yaml --session ./.session

Requires Node >= 20.

First run

Create a minimal workflow spec:

manifest_id: "@agenteer/node-regex-check"
input:
  input: "release 1.0.0-rc.1"
  rules:
    - id: contains-rc
      pattern: "1\\.0\\.0-rc\\.1"
      kind: must_match
granted: []

Run it and inspect the recorded session:

agenteer run --spec workflow.yaml --session ./.session
agenteer inspect --session ./.session --summary

Commands

| command | purpose | |---|---| | agenteer run --spec <file> --session <dir> | Run a workflow spec from scratch. | | agenteer resume --session <dir> | Resume a suspended session. | | agenteer ctx <subcommand> | Inspect the session context store. | | agenteer inspect --session <dir> | Render a session report. | | agenteer publish --dir <pkg> | Validate and publish a node package. | | agenteer install <spec> --workflow-dir <dir> | Install a node package into a workflow. | | agenteer search <query> | Search npm for Agenteer-shaped node packages. |

Programmatic use

import { inspectSession, resumeWorkflow, runWorkflow } from "@agenteer/cli";

const spec = {
  manifest_id: "@agenteer/node-regex-check",
  input: {
    input: "release 1.0.0-rc.1",
    rules: [
      {
        id: "contains-rc",
        pattern: "1\\.0\\.0-rc\\.1",
        kind: "must_match" as const,
      },
    ],
  },
  granted: [],
};

const { outcome } = await runWorkflow({
  spec,
  sessionDir: "./.session",
});

if (outcome.finalStatus === "suspended") {
  await resumeWorkflow({
    sessionDir: "./.session",
    answerProvider: async () => "approved",
  });
}

const report = await inspectSession("./.session");
console.log(report.state.status);

runWorkflow() and resumeWorkflow() return { sessionDir, sessionId, outcome }. Suspended runs use finalStatus: "suspended".

Providers

Bundled Anthropic and OpenAI ModelProvider adapters are available through buildProviderForModels.

import { buildProviderForModels } from "@agenteer/cli";

const provider = buildProviderForModels({
  modelIds: ["claude-sonnet-4-5", "gpt-4o"],
  anthropicApiKey: process.env.ANTHROPIC_API_KEY,
  openaiApiKey: process.env.OPENAI_API_KEY,
});

License

MIT — see LICENSE.