Introduction

pok is a file-based CLI framework for TypeScript. It builds a command tree from files, validates flags and context with Zod, executes commands and tasks through a shared runner, and routes terminal output through adapters.

// commands/deploy.ts
import { z } from "zod";
import { defineCommand } from "@pokit/core";

export const command = defineCommand({
  label: "Deploy to environment",
  context: {
    env: {
      from: "flag",
      schema: z.enum(["staging", "prod"]),
      description: "Target environment",
    },
  },
  run: async (r, ctx) => {
    await r.group("Deploy", { layout: "sequence" }, async (g) => {
      await g.activity("Build", () => r.exec("npm run build"));
      await g.activity("Push", () => r.exec(`deploy --env ${ctx.context.env}`));
    });
  },
});

# Run with flag
$ mycli deploy --env staging

# Or interactively, pok prompts for missing values
$ mycli deploy
? Select environment > staging / prod

Core model

File-based routing: commands are discovered from the filesystem with no registration layer.
Typed context: flags and context values are validated with Zod and inferred through the runner.
Event-driven output: commands emit semantic events and adapters render them.
Adapter-driven UI: core stays free of terminal dependencies while prompters, reporters, and tab UIs plug in separately.

Packages

Package	Role
`@pokit/core`	Core framework with zero TTY dependencies
`@pokit/prompter-clack`	Interactive prompts adapter
`@pokit/reporter-clack`	Terminal output adapter
`@pokit/opentui`	Tabbed terminal UI adapter
`@pokit/tabs-core`	Shared tabs logic
`@pokit/sdk-gen`	SDK generator for typed clients
`create-pokit`	Project scaffolding CLI