Unblocked Code

• Relevant context — For each coding task, Unblocked Code uses the Unblocked Context Engine to draw on relevant code, pull requests, issues, documentation, and team discussions. It uses only the data sources that the requesting user has permission to access.
• Runs remotely — Tasks run remotely and continue in the background if you close Unblocked or shut down your computer.
• Works everywhere — Unblocked Code integrates smoothly everywhere you already chat with Unblocked, so you can naturally hand off work when a conversation leads to a coding task.

​

How it works

• From Unblocked
• From Slack
• From GitHub

​

Initial setup

1

Enable Unblocked Code

An admin opens Settings › Coding Tasks under Automations and selects Set up Unblocked Code.

2

Install the GitHub App (GitHub Only)

Install the separate Unblocked Code GitHub App in each GitHub organization you want to use. This app provides the write access required to push code and open pull requests. During installation, select All repositories.

​

Configure the code environment

​

Secrets

​

Cloud-init scripts

• The script runs as root on Ubuntu 22.04 LTS, so you don’t need sudo.
• Reference configured secrets through environment variables, such as $NPM_TOKEN, rather than writing their values into the script. Unblocked exposes each secret to the cloud-init script only while it runs, so the value never appears in the script itself. Configured secrets are also available to the Unblocked Code agent while a task runs. Wrap references in double quotes ("$NPM_TOKEN") so the shell expands them safely.
• Run apt-get update before installing packages, and prefer apt-get over apt in scripts.
• Only Bash scripts are supported; cloud-config YAML is not.

#!/bin/bash
apt-get update
apt-get install -y nodejs npm

# Authenticate to a private registry using a configured secret.
npm config set //registry.npmjs.org/:_authToken "$NPM_TOKEN"

#!/bin/bash
apt-get update
apt-get install -y openjdk-17-jdk maven

#!/bin/bash
apt-get update
apt-get install -y ruby-full
gem install bundler

#!/bin/bash
apt-get update
apt-get install -y docker.io
systemctl enable --now docker
printf '%s' "$DOCKER_PASSWORD" | docker login your-registry.com --username "$DOCKER_USERNAME" --password-stdin

#!/bin/bash
# Join your private network so builds can reach internal services.
# Make sure TAILSCALE_AUTH_KEY is a configured secret.
curl -fsSL https://tailscale.com/install.sh | sh
tailscale up --authkey="$TAILSCALE_AUTH_KEY" --accept-routes --accept-dns=false

​

Network access

• 44.236.159.233/32
• 44.255.222.154/32

​

Test with SSH