Falcon CLI Commands

Complete reference for the global falcon CLI. All commands target mainnet by default — append --local for local replica.

ICFalcon Packages

Setup

Initialize project and manage local replica

s:init

Install all dependencies, build canister, start dev server

falcon s:init

Use case: First-time project setup

r:start

Start local dfx replica in background

falcon r:start

Use case: Local development

r:stop

Stop local dfx replica

falcon r:stop

Use case: Clean shutdown

Packages (icp-hub)

Install and manage packages from icp-hub registry

p:list

List all available packages from icp-hub

falcon p:list

Use case: Discover available modules

add pkg

Install a package by slug

falcon add pkg crud

Use case: Add functionality

p:push

Publish your package to icp-hub

falcon p:push mypkg

Use case: Share reusable modules

Scaffold

Generate modules with full backend + frontend layers

m:f

Scaffold complete module (storage, repo, service, API, frontend)

falcon m:f Order

Use case: Create new feature

Backend

Build, test, and deploy canister

b:test

Run all backend tests

falcon b:test --local

Use case: Verify logic before deploy

b:build

Compile Motoko canister

falcon b:build --local

Use case: Check compilation

b:deploy

Build and upgrade canister (never reinstall)

falcon b:deploy

Use case: Deploy to mainnet

b:hash

Get deployed module hash

falcon b:hash

Use case: Verify deployment

b:logs

Stream canister logs

falcon b:logs

Use case: Debug production issues

Canister

Inspect and interact with deployed canister

c:status

Cycles, memory, controllers, module hash

falcon c:status

Use case: Health check

c:ping

Test canister reachability

falcon c:ping --local

Use case: Verify canister is live

c:call

Call canister method (query by default)

falcon c:call getUser '("alice")' --local

Use case: Manual testing

c:list

List all canister IDs

falcon c:list

Use case: Check deployed IDs

c:id

Get this canister ID

falcon c:id

Use case: Quick ID lookup

Cycles

Monitor cycles balance and burn rate

y:bal

Show balance and estimated runway

falcon y:bal

Use case: Track canister health

y:addr

Get cycles ledger account ID

falcon y:addr

Use case: Top-up preparation

Production

Full build and deploy workflows

p:check

Build backend + frontend (no deploy)

falcon p:check

Use case: Pre-deploy verification

p:ship

Deploy backend + build frontend

falcon p:ship

Use case: Release new version

Frontend

Next.js development and build

f:dev

Start Next.js dev server

falcon f:dev

Use case: Frontend development

f:build

Static export for production

falcon f:build

Use case: Prepare for hosting

Users

Inspect user and feature counts

u:count

Show user count and feature status

falcon u:count

Use case: Monitor growth