Skip to content
Anyknown Docs

Getting started — Local Builder

The Local Builder connects your own AI agent — Claude Code, Codex, or Gemini CLI — to the Anyknown platform. You use your own AI subscription; @anyknown/cli handles authentication, App management, and pushing changes.

Prerequisites

Section titled “Prerequisites”
  • An Anyknown account.
  • Node.js 22 or later.
  • Your AI agent of choice (Claude Code recommended).

Install the CLI

Section titled “Install the CLI”
Terminal window
npm install -g @anyknown/cli

Or use it without installing:

Terminal window
npx @anyknown/cli <command>

Authenticate

Section titled “Authenticate”
Terminal window
anyknown login

This opens a browser for device-pair authentication and stores your token at ~/.anyknown/credentials.json.

Check who you are authenticated as:

Terminal window
anyknown whoami

Sign out:

Terminal window
anyknown logout

Work with Apps

Section titled “Work with Apps”

List your Apps

Section titled “List your Apps”
Terminal window
anyknown apps list

Clone an App to work on locally

Section titled “Clone an App to work on locally”
Terminal window
anyknown apps clone my-app

Files land in ~/anyknown-apps/my-app/ by default (override with ANYKNOWN_APPS_DIR).

Initialize a new local App workspace

Section titled “Initialize a new local App workspace”
Terminal window
anyknown apps init

Sets up the framework boundary files (manifest, server entry, SDK stub) for a new App. Does not generate any page or component content — the AI generates that.

Run the local dev server

Section titled “Run the local dev server”
Terminal window
anyknown apps dev

Starts a local dev server for the App using Cloudflare Workers tooling. Live-reloads on file changes.

Push changes to the platform

Section titled “Push changes to the platform”
Terminal window
anyknown apps push

Uploads the local working tree to the Anyknown platform.

Build the App

Section titled “Build the App”
Terminal window
anyknown apps build

Triggers a build on the platform. Surfaces build errors and exits non-zero on failure.

Deploy (push + build + preview)

Section titled “Deploy (push + build + preview)”
Terminal window
anyknown apps deploy

Pushes the local tree, builds it, and deploys to the App’s isolated preview slot. Add --verify to run smoke verification after deploy. Production is only reachable via anyknown apps promote, which the Customer must approve.

Verify a deployed preview

Section titled “Verify a deployed preview”
Terminal window
anyknown apps verify

Runs smoke verification against the deployed preview and prints a structured verdict: pass, broken, or inconclusive. Exits non-zero only on broken.

Pull context for your agent

Section titled “Pull context for your agent”
Terminal window
anyknown context plan <appSlug>
anyknown context db-schema <appSlug>
anyknown context feedback <appSlug>
anyknown context build-history <appSlug>

Pulls cloud-side context (latest plan, current DB schema, redacted Visitor feedback, build history) into your local agent’s context window. Use --json for structured output.

Targeting staging

Section titled “Targeting staging”
Terminal window
anyknown --env=staging apps list

Pass --env=staging to any command to target the staging environment.

Workflow skills

Section titled “Workflow skills”

Customer-facing workflow skills (automated iterate/build/read flows for your agent) are forthcoming.

Next steps

Section titled “Next steps”