A TypeScript CLI and skill suite for building agents on Google Cloud. Install with npm, run with Node.js 20+, and pair with any coding agent.

• TypeScript throughout — strict-mode CLI, library, and tests with shared base tsconfig
• Seven agent skills — installable knowledge packs for coding assistants
• Typed docs scripts — MkDocs site JavaScript compiled from src/docs/
• Zero Python runtime — no pyproject.toml, no uv, no mixed language tree

flowchart TB
  subgraph cli [agents-cli TypeScript CLI]
    Main[commander CLI]
    Info[info / setup]
    Skills[skills list]
  end

  subgraph lib [src/ library]
    Config[config/env]
    Logger[logger]
  end

  subgraph assets [Bundled assets]
    SkillsDir[skills/]
    DocsSite[docs/ MkDocs content]
  end

  Main --> Info
  Main --> Skills
  Main --> Config
  Skills --> SkillsDir

git clone https://github.com/google/agents-cli.git
cd agents-cli
npm install
npm run validate
node dist/cli/main.js --version

npm link
agents-cli info

npx skills add google/agents-cli

Copy .env.example to .env:

agents-cli/
├── src/
│   ├── cli/              # CLI entry (commander)
│   ├── config/           # Environment configuration + barrel export
│   ├── docs/             # MkDocs site scripts (→ docs/src/javascripts/)
│   ├── logger.ts
│   └── index.ts          # Library exports
├── tests/
├── skills/               # Agent skill markdown packages
├── docs/                 # MkDocs site content (optional build)
├── package.json          # commander, dotenv, zod
├── tsconfig.base.json    # Shared TS compiler baseline
├── tsconfig.json         # App + tests typecheck (no emit)
├── tsconfig.build.json   # Production build emit to dist/
└── tsconfig.docs.json    # Docs script compilation

npm install
npm run validate          # typecheck + lint + test + build
npm run test              # unit tests only
npm run build:app         # compile runtime library + CLI
npm run build:docs        # compile site scripts
agents-cli skills list

import { loadAppConfig } from "agents-cli";

const config = loadAppConfig();
console.log(config.logLevel);

import { loadAppConfig } from "agents-cli/config";
import { createLogger } from "agents-cli/logger";

Run npm run build then npm link, or use node dist/cli/main.js.

Ensure you cloned the full repo — skills live in skills/ at the repository root.

Is this the Google PyPI google-agents-cli package? This fork is a TypeScript reimplementation focused on tooling, skills, and Redis persistence. It does not include the original Python scaffold/deploy stack.

Do I need Python? No. The application runtime is Node.js only. MkDocs (optional) uses Python only if you build the docs site separately.

Is Redis required? No. This CLI is fully functional without Redis.

Apache 2.0 — see LICENSE.