Extra — macOS · Paperclip + AWS Bedrock · No static keys required

Paperclip
+ AWS Bedrock

Install Paperclip locally and wire it to AWS Bedrock using an ANTHROPIC_BEDROCK_BASE_URL token. No static AWS access keys needed.

Terminal — zsh
❯
bash <(curl -fsSL https://raw.githubusercontent.com/otto-ai-labs/setupai.dev/main/extra/paperclip-setup.sh) install
How it works

One command. Paperclip ready in minutes.

The script handles cloning, dependencies, Bedrock config, and the .env file — all interactively.

1

Check dependencies

Verifies Node.js 20+ and Git are installed. Installs pnpm automatically if missing.

2

Clone Paperclip

Clones paperclipai/paperclip into ~/paperclip (or your $PAPERCLIP_DIR) and runs pnpm install. Already installed? It pulls the latest instead.

3

Configure Bedrock

Prompts for your ANTHROPIC_BEDROCK_BASE_URL and AWS region. Writes them to ~/.zshenv and reloads the environment. Credentials are cached — re-running skips this prompt.

4

Write .env

Creates ~/paperclip/.env with your database URL, port 3100, and a randomly generated BETTER_AUTH_SECRET. File is chmod 600.

Commands

Three commands. That's all.

Run from the root of the mac-setup repo.

# Full install — clone, configure Bedrock, write .env bash <(curl -fsSL https://raw.githubusercontent.com/otto-ai-labs/setupai.dev/main/extra/paperclip-setup.sh) install # Re-enter your Bedrock base URL and region bash <(curl -fsSL https://raw.githubusercontent.com/otto-ai-labs/setupai.dev/main/extra/paperclip-setup.sh) update-token # Show current Bedrock configuration bash <(curl -fsSL https://raw.githubusercontent.com/otto-ai-labs/setupai.dev/main/extra/paperclip-setup.sh) status
Configuration

Environment variables & generated files.

All credentials are stored with chmod 600 and never hard-coded in the repo.

Shell environment — written to ~/.zshenv
VariablePurpose
ANTHROPIC_BEDROCK_BASE_URL Your Bedrock proxy endpoint (e.g. https://bedrock.us-east-1.amazonaws.com)
PAPERCLIP_AWS_REGION AWS region — defaults to us-east-1
PAPERCLIP_DIR Override install directory — set in your shell before running install (default: ~/paperclip)
Generated ~/paperclip/.env
DATABASE_URL=postgres://paperclip:paperclip@localhost:5432/paperclip PORT=3100 SERVE_UI=false BETTER_AUTH_SECRET=<40-char random string>

To use a different database, enter a custom DATABASE_URL when prompted, or delete ~/.claude/provider-backups/paperclip_db_url to re-prompt on next run.

After Install

Start Paperclip and connect Claude Code.

Four quick steps after the script finishes.

Reload your shell

Close and reopen your terminal, or run source ~/.zshenv to pick up the new Bedrock env vars.

Start Paperclip

cd ~/paperclip && pnpm dev — the server starts on port 3100.

Open the UI

Visit http://localhost:3100 in your browser.

Add a Claude Code agent

In the Paperclip UI, add an agent. Paperclip's claude-local adapter reads ANTHROPIC_BEDROCK_BASE_URL from your environment and automatically uses Bedrock model IDs.