Getting started.

1. Install the CLI

Download the prebuilt binary for your platform below and verify it against the published checksums before you run it. /downloads always serves the current release, so the commands below never need a version bump.

macOS (Apple Silicon). Download the archive and the checksums file, verify, extract, and install:

curl -sSLO https://fieldwick.com/downloads/fieldwick_macOS_arm64.tar.gz
curl -sSLO https://fieldwick.com/downloads/checksums.txt
shasum -a 256 -c checksums.txt --ignore-missing
tar -xzf fieldwick_macOS_arm64.tar.gz
sudo mv fieldwick /usr/local/bin/

macOS (Intel). Same steps, with the Intel archive:

curl -sSLO https://fieldwick.com/downloads/fieldwick_macOS_amd64.tar.gz
curl -sSLO https://fieldwick.com/downloads/checksums.txt
shasum -a 256 -c checksums.txt --ignore-missing
tar -xzf fieldwick_macOS_amd64.tar.gz
sudo mv fieldwick /usr/local/bin/

Linux (amd64). Same shape, with sha256sum for the checksum check:

curl -sSLO https://fieldwick.com/downloads/fieldwick_linux_amd64.tar.gz
curl -sSLO https://fieldwick.com/downloads/checksums.txt
sha256sum -c checksums.txt --ignore-missing
tar -xzf fieldwick_linux_amd64.tar.gz
sudo mv fieldwick /usr/local/bin/

Building from source (fallback). No prebuilt binary for your platform, or you need an unreleased commit? Clone the source repository and build it yourself with Go 1.22 or later:

cd fieldwick/cli
go build -o /usr/local/bin/fieldwick .

Verify the install worked, whichever path you took:

fieldwick --version

2. Sign up and log in

Create an account at app.fieldwick.com/sign-up. Google OAuth is supported. No card is required on the Starter tier.

Once your account exists, authenticate the CLI. The default flow opens a device-auth page in your browser and polls for approval:

fieldwick login

Prefer to stay in the terminal? Sign up and log in without leaving the shell:

fieldwick signup you@example.com
fieldwick login

For CI or agent environments, generate a token in the dashboard and pass it with fieldwick login --token $FIELDWICK_TOKEN.

3. Deploy your first app

From inside your project directory, run fieldwick init to detect your language and framework. It writes a fieldwick.json into the current directory.

fieldwick init

Create a service to deploy into. The service holds your live instance, scaling settings, and deploy history:

fieldwick services create --name my-api --region us-east-1

Trigger a deploy and wait for it to reach a terminal state. The CLI exits 0 on success and 1 on failure, so it is safe to use in a CI pipeline:

fieldwick deploy --wait

Once the deploy finishes, the CLI prints your live URL. The service ID is written back into fieldwick.json so subsequent deploys from the same directory need no extra arguments.

For AI agents

The exact same three-step flow runs through the Fieldwick MCP server. Register the server with your agent host and it exposes tools for signup, login, init, and deploy that an agent can call directly without a shell.

The CLI is designed to be machine-readable. Add --json to any read command to get structured output instead of human- formatted tables. The deploy --wait flag emits a machine-readable exit code (0 = success, 1 = failure, 124 = timeout) so agents can branch on deploy outcome without parsing log lines.

# agent-friendly: structured output + reliable exit codes
fieldwick services --json
fieldwick deploy --wait --json

What is in fieldwick.json?

The config file lives at the root of your project. You can commit it to version control - it contains no secrets. A minimal example for a Node.js API looks like this:

{
  "name": "my-api",
  "region": "us-east-1",
  "build": {
    "command": "npm ci && npm run build"
  },
  "start": {
    "command": "node dist/server.js",
    "port": 3000
  }
}

After fieldwick services create runs, the CLI appends a serviceId field so subsequent deploys know which service to target.