Quickstart

Quickstart

This page gives the shortest safe path to useful output from npm.

Install

npm install percolation-inversion-compiler-ts

For one-off use, you can run the CLI through npx:

npx pic-ts agent check --compact --text "Candidate packet: preserve residuals." --profile development

Recommended CLI Name

Use pic-ts for this npm package.

The package also installs pic as a compatibility alias. If the Python package is installed on the same machine, pic may refer to either implementation depending on your PATH. Use pic-ts when you specifically want the Node.js package.

First Three Commands

npx pic-ts agent check --compact --text "Candidate packet: preserve residuals." --profile development
npx pic-ts phase plan --compact --text "Candidate packet: preserve residuals." --profile development
npx pic-ts agent accelerate --compact --text "Candidate packet: preserve residuals." --profile development

Read these fields first:

• accepted
• workflow_usable
• operationally_usable
• settled
• missing_obligations
• residual_ledger
• candidate_only_reasons
• settled_blockers

settled=false is not a command failure. It means unfinished work is still visible.

Python-Free Demo

Create demo files and run a local agent loop:

npx pic-ts demo bootstrap --output-dir .pic-demo --overwrite
npx pic-ts runtime step --state .pic-demo/runtime_state.json --input .pic-demo/runtime_step_input.json --output .pic-demo/runtime_step_report.generated.json
npx pic-ts packet export --report .pic-demo/runtime_step_report.generated.json --output .pic-demo/packet.json
npx pic-ts packet inspect --packet .pic-demo/packet.json
npx pic-ts phase plan --request .pic-demo/asi_proxy_phase_request.json --compact

This demo works without Python.

Next Pages

• Getting Started
• Node Only Agent Loop
• How To Read The JSON
• CLI Recipes