Skip to main content

Documentation Index

Fetch the complete documentation index at: https://docs.qredence.ai/llms.txt

Use this file to discover all available pages before exploring further.

Get Fleet Pi running locally with Pi-backed chat and repo-scoped tools.

​
Prerequisites

  • Node.js 22 or newer — nodejs.org
  • pnpm 10.33.3 — matches the pinned packageManager field in package.json
  • AWS account with Bedrock access — Claude models must be enabled in your region
  • AWS credentials configured — ~/.aws/credentials, environment variables, or an IAM role
AWS_REGION defaults to us-east-1 when unset.
Enable Corepack once so the pinned pnpm version is used automatically:
corepack enable
corepack prepare pnpm@10.33.3 --activate

​
1. Clone and install

git clone https://github.com/Qredence/fleet-pi.git
cd fleet-pi
pnpm install

​
2. Create local configuration

cp .env.example .env
apps/web/vite.config.ts loads .env from the repo root for server-side routes. The checked-in example only includes public-safe knobs. Typical choices:
  • Set AWS_PROFILE in your shell if you use named local AWS profiles.
  • Set AWS_BEARER_TOKEN_BEDROCK only if your Bedrock setup uses bearer-token auth.
  • Leave PI_AGENT_DIR unset unless you intentionally want a non-default Pi agent resource directory.

​
3. Start the app

pnpm dev
Open http://localhost:3000.

​
4. Smoke check

In a second terminal: 
curl http://localhost:3000/api/health
Expected response: 
{ "status": "ok" }
Then send a simple prompt like read package.json in the chat UI and confirm that a Read tool card appears.

​
What “standalone” means

Standalone does not mean “without Pi” or “without an LLM provider.” It means:
  • You run Fleet Pi locally as a normal pnpm web app.
  • The bundled Pi runtime powers chat and tool execution.
  • The backend still expects working Bedrock access.
  • You do not need the Codex desktop app or the advanced Codex worktree flow.

​
Useful commands

pnpm dev          # start the dev server
pnpm typecheck    # TypeScript across the workspace
pnpm lint         # ESLint
pnpm --filter web test
pnpm e2e          # end-to-end tests
pnpm build        # production build

​
Next steps

Agent workspace

Learn how durable memory, plans, and Pi resources live in Git.

Adaptive workspace

The canonical workspace contract and projection boundary.

Codex setup

The advanced shared Codex environment and worktree flow.

Architecture

Browser client, TanStack Start backend, and agent workspace boundaries.