thinkwork-cli

Deploy and manage Thinkwork AI agent stacks on AWS.

Install

npm install -g thinkwork-cli

Or run without installing:

npx thinkwork-cli --help

Quick Start

# 1. Authenticate with AWS
thinkwork login

# 2. Check prerequisites
thinkwork doctor -s dev

# 3. Initialize a new environment (interactive)
thinkwork init -s dev

# 4. Review the plan
thinkwork plan -s dev

# 5. Deploy (~5 min)
thinkwork deploy -s dev

# 6. Seed workspace files + skill catalog
thinkwork bootstrap -s dev

# 7. Show what was deployed
thinkwork outputs -s dev

No repo clone required — thinkwork init scaffolds all Terraform modules from the npm package.

Commands

Setup

| Command | Description | |---------|-------------| | thinkwork login | Configure AWS credentials (access keys or --sso) | | thinkwork init -s <stage> | Initialize a new environment — generates terraform.tfvars, scaffolds Terraform modules, runs terraform init | | thinkwork doctor -s <stage> | Check prerequisites (AWS CLI, Terraform, credentials, Bedrock access) |

Deploy

| Command | Description | |---------|-------------| | thinkwork plan -s <stage> | Preview infrastructure changes | | thinkwork deploy -s <stage> | Deploy infrastructure (terraform apply) | | thinkwork bootstrap -s <stage> | Seed workspace defaults, skill catalog, and per-tenant files | | thinkwork destroy -s <stage> | Tear down infrastructure |

Manage

| Command | Description | |---------|-------------| | thinkwork status | Discover all deployed environments in AWS (clickable URLs) | | thinkwork status -s <stage> | Detailed view for one environment | | thinkwork outputs -s <stage> | Show deployment outputs (API URL, Cognito IDs, etc.) | | thinkwork config list | List all initialized environments | | thinkwork config list -s <stage> | Show full config for an environment (secrets masked) | | thinkwork config get <key> -s <stage> | Read a configuration value | | thinkwork config set <key> <value> -s <stage> | Update a configuration value |

Options

-s, --stage <name>      Deployment stage (required for most commands)
-p, --profile <name>    AWS profile to use
-c, --component <tier>  Component tier: foundation, data, app, or all (default: all)
-y, --yes               Skip confirmation prompts (for CI)
--defaults              Skip interactive prompts in init (use all defaults)
-v, --version           Print CLI version
-h, --help              Show help

Interactive Init

thinkwork init walks you through all configuration options:

• AWS Region — where to deploy (default: us-east-1)
• Database engine — aurora-serverless (production) or rds-postgres (dev, cheaper)
• Hindsight add-on — optional y/N (managed AgentCore memory with automatic per-turn retention is always on; Hindsight adds ECS Fargate semantic + entity-graph retrieval alongside it)
• Google OAuth — optional social login for Cognito
• Admin UI URL — callback URL for the admin dashboard
• Mobile app scheme — deep link scheme for the mobile app
• Secrets — DB password and API auth secret are auto-generated

For CI, use --defaults to skip prompts:

thinkwork init -s staging --defaults

Environment Registry

All initialized environments are saved to ~/.thinkwork/environments/<stage>/config.json. This means:

• No cd required — all commands auto-resolve the terraform directory
• List all stages — thinkwork config list shows a table of all environments
• Inspect any stage — thinkwork config list -s dev shows full config

Examples

Check all environments

thinkwork status

  ⬡ dev
  ─────────────────────────────────────────
  Source:          AWS + local config
  Region:          us-east-1
  Account:         123456789012
  Lambda fns:      42
  AgentCore:       Active
  Memory:          managed (always on)
  Hindsight:       healthy
  ...

URLs are clickable in supported terminals (iTerm2, Windows Terminal, VS Code, etc.).

Enable the Hindsight memory add-on

Managed AgentCore memory is always on. To also enable Hindsight (ECS Fargate service for semantic + entity-graph retrieval) alongside it:

thinkwork config set enable-hindsight true -s dev --apply

Deploy a specific tier

thinkwork deploy -s dev -c app

Use with AWS SSO

thinkwork login --sso --profile my-org
thinkwork deploy -s dev --profile my-org

CI/CD (non-interactive)

thinkwork init -s prod --defaults
thinkwork deploy -s prod -y
thinkwork bootstrap -s prod

Prerequisites

• Node.js >= 20
• AWS CLI v2
• Terraform >= 1.5
• AWS account with Bedrock model access enabled

What Gets Deployed

Thinkwork provisions a complete AI agent stack (~250 AWS resources):

• Compute: Lambda functions (39 handlers), AgentCore container (Lambda + ECR)
• Database: Aurora Serverless PostgreSQL with pgvector
• Auth: Cognito user pool (admin + mobile clients)
• API: API Gateway (REST + GraphQL), AppSync (WebSocket subscriptions)
• Storage: S3 (workspace files, skills, knowledge bases)
• Memory: Managed (built-in) or Hindsight (ECS Fargate with semantic + BM25 + entity graph retrieval)

License

MIT