pica-cli

Public release repository for the Picadabra CLI.

This repository hosts:

• GitHub Releases for the executable pica JavaScript bundle
• Release checksums and the machine-readable update manifest
• The public installer script at the repository root
• Public issue tracking for distribution concerns

The source code lives in a private monorepo. Releases in this repository are published automatically from the upstream build pipeline.

Install With Script

curl -fsSL https://raw.githubusercontent.com/AIGC-Hackers/pica-cli/main/install.sh | bash

To install a specific version:

curl -fsSL https://raw.githubusercontent.com/AIGC-Hackers/pica-cli/main/install.sh | bash -s 0.2.10

Default install path is ~/.local/bin. Override with PICA_INSTALL_DIR:

PICA_INSTALL_DIR=/usr/local/bin curl -fsSL https://raw.githubusercontent.com/AIGC-Hackers/pica-cli/main/install.sh | bash

The installer downloads pica-manifest.json for the chosen release, verifies pica-bundle.tar.gz, installs Bun when it is missing or below the required minimum version, and installs pica as a thin wrapper over the managed bundle layout under ~/.local/share/pica/cli.

Direct Download

Download pica-bundle.tar.gz and pica-manifest.json from the Releases page, extract the bundle, and place pica.js in your preferred managed layout if you do not want to use the installer script.

Each release also includes a checksums.txt file with SHA-256 digests.

After Install

After installing pica, complete the initial setup before using CLI features that talk to Picadabra services.

1. Sign in and create an API key

1. Visit https://picadabra.ai/ and sign in.
2. Open the dashboard.
3. Go to API Keys.
4. Click Create new key and copy the generated key to a secure place.

If you cannot load the API key page, make sure you have completed sign-in first.

2. Install the Picadabra skill into your agent workspace

Install the official Picadabra skill in the working directory where your agent runs:

pica skill install picadabra/pica

This installs the Picadabra skill locally so your agent can discover and use Picadabra capabilities from the current workspace.

3. Continue with CLI setup

Use the API key you created above with the relevant pica authentication or configuration flow in your environment, then verify the active setup with:

pica status

Current Limits

• ffmpeg and ffprobe are not bundled yet.
• Commands that rely on local media probing may require system tooling until the managed toolchain work lands.

Support

• Release issues: open an issue in this repository
• Product and source work: handled in the private upstream repository