BRIK64 CLI

BRIK64 CLI is the public beta command-line surface for local BRIK64 project workflows. It helps developers initialize .brik metadata, work with PCD files, create local candidate evidence, emit supported language targets, and prepare artifacts for managed platform workflows.

Current public beta: 0.1.0-beta.18.2

Install

The public CLI install path remains curl-only:

curl -fsSL https://brik64.com/cli/install.sh | bash

After installation:

brik64 --version
brik64 help

The npm package namespace is reserved for SDK libraries, not CLI installation.

Beta18.2 Boundary

0.1.0-beta.18.2 is a versioned public beta for the Developer Assurance Loop. It keeps local workspace commands focused on deterministic offline review, package integrity, scoped blueprint reporting, and explicit handoff to managed public surfaces.

The previous public beta packages and archives are not rewritten by this follow-up. Beta18.2 publishes as its own versioned CLI package and public manifest entry when the release train closes.

Beta18.2 Command Surface

This public beta keeps the local workflow focused on explicit bounded-domain PCD review, SDK logic inventories where PCD is not the right adoption path, and honest inspection drafts when the repository can only be mapped.

• brik64 init --profile <startup|regulated|sdk-first|pcd-first> --structure <monolithic|modular> creates .brik/manifest.json, .brik/ledger/, and optional project folders for modular local review. It does not create AGENTS.md.
• brik64 audit [path] --out <dir> runs the Developer Assurance Loop and writes audit results, blueprint material, and unsupported-logic notes.
• brik64 explain <file.pcd> --suggest --fix-plan reports parser and semantic guidance with actionable repair steps.
• brik64 test <file.pcd> --generate-scenarios runs native local scenario checks without requiring emitted language targets.
• brik64 diff <old.pcd> <new.pcd> --impact compares PCD ASTs and reports semantic review notes.
• brik64 doc <file.pcd|repo> --blueprint --format <markdown|mermaid> writes visual blueprint documentation from local evidence.
• brik64 lint-policy [path] --policy <gdpr|security|startup-readiness|all> performs static hygiene checks. It is not a compliance certificate.
• brik64 ledger status|verify|snapshot|tombstone|export|repair --dry-run inspects the local append-only ledger chain.
• brik64 doctor reports local workspace and ledger status; --json is for CI. It fails when local audit reports claim release readiness while the workspace manifest is still local-candidate only.
• brik64 pcd generate <name> creates a starter PCD candidate.
• brik64 certify writes local candidate evidence only.
• brik64 polymerize writes a local polymer candidate. Multi-input inline polymers require --root <fn> so the entrypoint is explicit. Source polymers intended for review should use the .polymer.pcd suffix.
• brik64 compile all emits supported local targets for candidate workflows.
• brik64 test all runs local candidate checks.
• brik64 monomers test --all --json reports the 128-entry registry status for local candidate validation.

Managed cloud paths remain entitlement-gated. Without a managed session, those paths fail closed and keep local artifacts unchanged.

Platform Support

Platform	Status	Notes
macOS	Available in current public beta	Portable package; requires the documented runtime for the active public installer.
Linux	Available in current public beta	Portable package; requires the documented runtime for the active public installer.
Windows x64 native	Not available in current public beta	No Windows executable is published.

SDK Boundary

SDKs are distributed separately from the CLI. This CLI follow-up expects aligned SDK marketplace coordinates when the release train publishes. The target Beta18.2 SDK coordinates are:

npm install @brik64/core@0.1.0-beta.18.2
pip install brik64==0.1.0b18.post2
cargo add brik64-core@0.1.0-beta.18.2

SDK packages are language libraries. They do not install the CLI, issue managed claims, or replace the CLI workspace workflow.

Claim Boundary

This beta provides local candidate evidence and managed-workflow routing boundaries. The local ledger is a tamper-evident workspace history, not a distributed blockchain and not a formal certificate. This beta does not by itself establish formal certification for arbitrary user code. It does not establish universal correctness or independent toolchain closure. It does not establish native Windows compatibility.

Local Ledger

Beta16.1.x records selected workspace actions in .brik/ledger/events.jsonl with a hash chain and .brik/ledger/head.json head pointer. Event payloads are redacted by default: raw source, raw PCD content, absolute paths, and secrets are not written to the ledger event body.

Useful commands:

brik64 ledger status
brik64 ledger verify --json
brik64 ledger export --redacted
brik64 ledger tombstone <event-hash> --reason "superseded by follow-up evidence"

Ledger verification fails closed when events are edited, deleted, reordered, or when required ledger files are missing from an initialized workspace.

CLI And Agent Skill

Use the CLI for local project actions and the official brik64 skill for agent behavior, claim-safe reporting, .brik traceability, PCD workflow, and consent-based AGENTS.md handling.

brik64 init prepares local BRIK64 metadata. It does not create or modify AGENTS.md.

Repository Map

Path	What it contains
src/brik.js	Node.js entry point for current public beta command behavior.
tests/smoke.sh	Local smoke test for current beta command behavior.
pcd/	Candidate PCD seed material for command structure.
evidence/	Public beta evidence notes and generated-review placeholders.
packaging/	Platform packaging notes and release-lane material.
docs/	Release, distribution, governance, platform, and testing docs.
.brik/manifest.json	Local traceability metadata. It is not a certificate.

Release Evidence

Use GitHub Release assets, release manifest, and SHA256SUMS to review the latest published package.

https://github.com/brik64/brik64-cli/releases

Copyright And License

Copyright (c) 2026 BRIK64 INC. All rights reserved.

See LICENSE and NOTICE. BRIK64 CLI public beta is proprietary evaluation software from BRIK64 INC.