How do I install the Dev Environment skill?

Run npx skillmds@latest add blaxel-ai/dev-environment in your terminal (requires Node.js), paste this page's agent-chat prompt into Claude, Cursor, or any MCP-connected agent, or download the SKILL.md file and copy it into your agent's skills directory.

Is Dev Environment safe to use?

This skill has not completed SkillMD's automated safety review yet. SkillMD never runs a skill's scripts for you; review the SKILL.md before installing.

Which AI agents work with Dev Environment?

This skill is tagged as working with Claude Code, Claude.ai, OpenAI Codex. SKILL.md is an open format, so most agents that read a skills directory can load it too.

Is Dev Environment free to use?

Yes. Installing skills from SkillMD is free, and the skill stays under its author's original license.

Who published Dev Environment?

blaxel-ai (@blaxel-ai) published this skill. Their other Agent Skills are listed on their SkillMD profile.

Dev Environment by blaxel-ai — Agent Skill

Name: Dev Environment
Author: blaxel-ai

File contents

Start the Local Dev Environment

The sandbox-api runs inside Docker with Air for hot-reload. Changes to Go files in sandbox-api/ are picked up automatically without restarting the container.

Prerequisites

Install dev dependencies (one-time):

make dependencies

This installs:

air — hot-reload for Go
swag — OpenAPI doc generation
yq — YAML processor (via brew)

Start the Dev Server

Important: Before starting, kill any existing process on port 8080:

lsof -ti :8080 | xargs kill -9 2>/dev/null || true

docker-compose up dev

This starts the dev service defined in docker-compose.yaml, which:

Builds from docker/alpine.Dockerfile
Mounts ./sandbox-api and ./tmp as volumes
Sets SANDBOX_DEV_MODE=true
Exposes port 8080 (sandbox-api) and 3010
Runs air for hot-reload

Wait for this log line before testing:

Starting Sandbox API server on :8080

Verify It's Running

curl http://localhost:8080/health

Or test the filesystem endpoint:

curl http://localhost:8080/filesystem/~

Alternative: Run Without Docker (Faster Iteration)

If you want to skip Docker and run air directly on the host:

lsof -ti :8080 | xargs kill -9 2>/dev/null || true
make api

This runs air with SANDBOX_LOG_DIR=./tmp/log from the sandbox-api/ directory. Requires Go installed locally.

Slim Dev Image (No Source Mount)

For testing the production-like image without hot-reload:

docker-compose up dev-slim

This builds from docker/slim.Dockerfile — no volume mounts, no hot-reload.

Run Unit Tests

make test

Runs go test -v ./... from within sandbox-api/. These are fast in-process tests.

Build the Docker Image

make docker-build

Builds blaxel/sandbox-api:latest. To run it:

make docker-run

Logs

Dev logs are written to ./tmp/log/ on the host (mounted from the container). Tail them with:

tail -f tmp/log/*.log

---name: dev-environmentdescription: Start the local sandbox-api development environment with hot-reload. Use when developing or testing changes to the sandbox-api Go code locally.---# Start the Local Dev EnvironmentThe sandbox-api runs inside Docker with Air for hot-reload. Changes to Go files in `sandbox-api/` are picked up automatically without restarting the container.## PrerequisitesInstall dev dependencies (one-time):```bashmake dependencies```This installs:- `air` — hot-reload for Go- `swag` — OpenAPI doc generation- `yq` — YAML processor (via brew)---## Start the Dev Server**Important:** Before starting, kill any existing process on port 8080:```bashlsof -ti :8080 | xargs kill -9 2>/dev/null || true``````bashdocker-compose up dev```This starts the `dev` service defined in `docker-compose.yaml`, which:- Builds from `docker/alpine.Dockerfile`- Mounts `./sandbox-api` and `./tmp` as volumes- Sets `SANDBOX_DEV_MODE=true`- Exposes port `8080` (sandbox-api) and `3010`- Runs `air` for hot-reloadWait for this log line before testing:```Starting Sandbox API server on :8080```---## Verify It's Running```bashcurl http://localhost:8080/health```Or test the filesystem endpoint:```bashcurl http://localhost:8080/filesystem/~```---## Alternative: Run Without Docker (Faster Iteration)If you want to skip Docker and run air directly on the host:```bashlsof -ti :8080 | xargs kill -9 2>/dev/null || truemake api```This runs `air` with `SANDBOX_LOG_DIR=./tmp/log` from the `sandbox-api/` directory. Requires Go installed locally.---## Slim Dev Image (No Source Mount)For testing the production-like image without hot-reload:```bashdocker-compose up dev-slim```This builds from `docker/slim.Dockerfile` — no volume mounts, no hot-reload.---## Run Unit Tests```bashmake test```Runs `go test -v ./...` from within `sandbox-api/`. These are fast in-process tests.---## Build the Docker Image```bashmake docker-build```Builds `blaxel/sandbox-api:latest`. To run it:```bashmake docker-run```---## LogsDev logs are written to `./tmp/log/` on the host (mounted from the container). Tail them with:```bashtail -f tmp/log/*.log```

Frequently asked questions

Dev Environment