Plico

Plico is a TypeScript-first agent app kit built around local Markdown instructions, skills, tools, evals, memory, and artifacts.

This repo is intentionally narrow in phase one:

• scaffold valid Plico projects
• validate projects with @plico/core
• expose validation and dry runs through @plico/cli
• expose persisted runs, replay, and the native HTTP API through @plico/server
• generate the internal-ops starter with create-plico

Repo Layout

• packages/core contains the project loader and validator
• packages/cli contains plico validate [path], plico run --dry, plico runs, plico events, and plico serve
• packages/create-plico contains the scaffold generator
• examples/internal-ops-agent is the canonical internal-ops starter project

Local Development

Install dependencies:

pnpm install

Run the repo checks:

pnpm lint
pnpm test
pnpm build

Or run the full local check in one shot:

pnpm check

Formatting And Linting

The repo uses Biome for formatting and linting.

• pnpm format writes formatting fixes
• pnpm lint checks formatting and lint rules

Hooks

Husky runs lint-staged on commit so staged JS, TS, and JSON files are checked before they land.

Validation

Validate the example project from the repo root:

pnpm --filter @plico/cli exec plico validate examples/internal-ops-agent

Run the dry runtime with the checked-in example tool:

pnpm --filter @plico/cli exec plico run --dry --script examples/internal-ops-agent/evals/smoke.script.json examples/internal-ops-agent

Persist the smoke run, list stored runs, replay events, and start the native API server:

pnpm --filter @plico/cli exec plico run --dry --persist --script examples/internal-ops-agent/evals/smoke.script.json examples/internal-ops-agent
pnpm --filter @plico/cli exec plico runs examples/internal-ops-agent
pnpm --filter @plico/cli exec plico events <run-id> examples/internal-ops-agent
pnpm --filter @plico/cli exec plico serve --db examples/internal-ops-agent/.plico/plico.sqlite examples/internal-ops-agent

Scaffold

Generate a new internal-ops starter:

pnpm --filter create-plico exec create-plico my-plico