Skip to content

LOCAL_AWS_SETUP.md

Latest commit

 

History

History
180 lines (145 loc) · 5.96 KB

LOCAL_AWS_SETUP.md

File metadata and controls

180 lines (145 loc) · 5.96 KB

Local Build & AWS Bedrock Setup

Instructions for cloning, building, and running the Flexion fork of opencode with AWS Bedrock.

Prerequisites

  • Bun v1.3+
  • AWS CLI v2
  • Git + SSH key configured for GitHub (with access to the flexion org)

Clone & Build

git clone git@github.com:flexion/opencode.git
cd opencode

# Switch to the Flexion customizations branch
git checkout flex

# Install dependencies
# Note: if your global ~/.npmrc redirects to a private registry (e.g. CMS Artifactory),
# override it so public packages resolve correctly:
BUN_CONFIG_REGISTRY=https://registry.npmjs.org bun install

# Build for your current platform only
BUN_CONFIG_REGISTRY=https://registry.npmjs.org bun run --cwd packages/opencode build --single --skip-embed-web-ui

The binary will be at:

  • macOS ARM64: packages/opencode/dist/opencode-darwin-arm64/bin/opencode
  • macOS x64: packages/opencode/dist/opencode-darwin-x64/bin/opencode
  • Linux ARM64: packages/opencode/dist/opencode-linux-arm64/bin/opencode
  • Linux x64: packages/opencode/dist/opencode-linux-x64/bin/opencode

Verify the build:

./packages/opencode/dist/opencode-darwin-arm64/bin/opencode --version

AWS Bedrock Setup

1. Configure AWS SSO profile

Add to ~/.aws/config:

[profile AdministratorAccess]
sso_start_url = <your-sso-start-url>
sso_region = <your-sso-region>
sso_account_id = <your-account-id>
sso_role_name = AdministratorAccess
region = <your-preferred-region>

2. Configure opencode for Bedrock

Create ~/.config/opencode/opencode.json:

{
  "$schema": "https://opencode.ai/config.json",
  "model": "amazon-bedrock/us.anthropic.claude-sonnet-4-6",
  "enabled_providers": ["amazon-bedrock"],
  "plugin": [],
  "provider": {
    "amazon-bedrock": {
      "options": {
        "region": "<your-preferred-region>"
      },
      "models": {
        "writer.palmyra-x4": {
          "id": "us.writer.palmyra-x4-v1:0",
          "name": "Writer Palmyra X4",
          "tool_call": false,
          "limit": { "context": 128000, "output": 8192 }
        },
        "writer.palmyra-x5": {
          "id": "us.writer.palmyra-x5-v1:0",
          "name": "Writer Palmyra X5",
          "tool_call": false,
          "limit": { "context": 1000000, "output": 8192 }
        },
        "deepseek.r1": {
          "id": "us.deepseek.r1-v1:0",
          "name": "DeepSeek R1",
          "tool_call": false,
          "limit": { "context": 64000, "output": 32768 }
        },
        "mistral.pixtral-large-2502": {
          "id": "us.mistral.pixtral-large-2502-v1:0",
          "name": "Mistral Pixtral Large",
          "tool_call": false,
          "limit": { "context": 128000, "output": 8192 }
        },
        "meta.llama4-maverick-17b-instruct": {
          "id": "us.meta.llama4-maverick-17b-instruct-v1:0",
          "name": "Meta Llama 4 Maverick 17B",
          "tool_call": false,
          "limit": { "context": 1000000, "output": 8192 }
        },
        "meta.llama4-scout-17b-instruct": {
          "id": "us.meta.llama4-scout-17b-instruct-v1:0",
          "name": "Meta Llama 4 Scout 17B",
          "tool_call": false,
          "limit": { "context": 10000000, "output": 8192 }
        },
        "amazon.nova-2-lite": {
          "id": "us.amazon.nova-2-lite-v1:0",
          "name": "Amazon Nova 2 Lite",
          "limit": { "context": 300000, "output": 5120 }
        }
      }
    }
  }
}

Note on tool_call: false: Models marked with tool_call: false do not support tool use in streaming mode on Bedrock. This config prevents opencode from sending tool definitions to those models. The flex branch includes a fix that makes tool_call: false actually respected at runtime — see the tracking PR flexion/opencode#2 for details.

3. Shell alias

Add to ~/.zshrc or ~/.bashrc:

opencode-work() {
  local profile="AdministratorAccess"
  echo "Logging in to AWS SSO ($profile)..."
  aws sso login --profile "$profile" || return 1
  eval "$(aws configure export-credentials --profile "$profile" --format env)"
  /path/to/opencode/packages/opencode/dist/opencode-darwin-arm64/bin/opencode "$@"
}

Replace /path/to/opencode with where you cloned the repo (e.g. ~/Code/personal/flexion-work-items/flexchat-stack/opencode).

4. Usage

# Login and launch
opencode-work

# Re-running after SSO session expires — just run again, it will re-authenticate
opencode-work

Keeping the Fork Up to Date

When upstream releases a new version, sync dev and rebase flex:

git fetch upstream  # upstream = https://github.com/anomalyco/opencode.git
git checkout dev
git reset --hard upstream/dev
git push origin dev --force

git checkout flex
git rebase dev
# Resolve any conflicts, then:
git push origin flex --force

See flexion/opencode#2 for the full list of Flexion customizations and conflict resolution notes.

What's Different in This Fork (flex branch)

Change File(s) Description
Hide skill prompt text from chat UI packages/opencode/src/session/prompt.ts Marks skill template as synthetic so the full prompt is sent to the model but hidden from the user
Respect tool_call: false at runtime packages/opencode/src/session/llm.ts Gates tool resolution behind capabilities.toolcall — fixes failures on Bedrock models that don't support streaming + tool use
Re-sign macOS binaries after build packages/opencode/script/build.ts Strips Bun's embedded signature and applies a fresh ad-hoc one — fixes SIGKILL (exit 137) on Darwin 25+ where Bun's signature format is rejected
Local build & AWS Bedrock setup docs LOCAL_AWS_SETUP.md This file

Full details and upstream tracking: flexion/opencode#2

Upstream issue: anomalyco/opencode#19966