wallfacer-cli

wallfacer

Command-line interface for Wallfacer — cloud dev environments for coding agents. Wallfacer runs Claude inside a real cloud dev environment with your repo, services, Docker, Xcode, and the iOS Simulator. Control the whole task from any device, CI workflow, or API.

Built with openapi-cli-generator, all commands are auto-generated from the Wallfacer API OpenAPI spec.

Installation

From source

git clone https://github.com/WallfacerTech/wallfacer-cli.git
cd wallfacer-cli
make

Authentication

Store your API token (created via POST /v1/tokens):

wallfacer auth login --token=<your-token>

Check that it works:

wallfacer auth status

Usage

# List accounts
wallfacer accounts list

# Get a specific account
wallfacer accounts get <account-id>

# List environments for an account
wallfacer environments list <account-id>

# Create a task
echo '{"prompt": "fix the login bug"}' | wallfacer tasks create <account-id>

# Wait for snapshot and boot a VM in one step
wallfacer up <environment-id>

# Execute a command in a VM (shortcut)
wallfacer exec --vm <vm-id> -- ls -la /workspace
wallfacer exec --vm <vm-id> --dir /workspace --timeout 60 -- make build

# Get help for any command
wallfacer <command> --help

Every command group has its own --help. Run wallfacer --help to see all available groups, or wallfacer <group> --help for details on a specific group (e.g. wallfacer auth --help).

If you set account_id in the config file, the account-id argument is automatically injected and can be omitted.

Configuration

Configuration is stored in ~/.wallfacer/wallfacer.yml:

token: <your-api-token>
account_id: <default-account-id>
base_url: https://api.wallfacer.ai  # optional override

Environment variables with the WALLFACER_ prefix are also supported (e.g. WALLFACER_TOKEN).

Agent Skills

The skills/wallfacer-cli/ directory contains a Claude Code agent skill that teaches agents how to use this CLI. It includes:

• SKILL.md — Skill definition with command map and usage patterns
• references/config.md — Config file layout and auth
• references/environments.md — Environment and snapshot operations
• references/tasks.md — Tasks, sessions, messages, and attachments
• references/vms.md — VM lifecycle, exec, logs, and simulator

Development

The CLI commands in openapi.go are generated from openapi.yaml. To regenerate after updating the spec:

make generate

This requires the openapi-cli-generator repo to be cloned alongside this one (as ../openapi-cli-generator).

Note: go.mod uses a replace directive pointing to ../openapi-cli-generator because the generator repo is currently private. go install from a remote module path will not work until the generator repo is made public. For now, build from a local clone with the sibling repo present.