claudetainer

🥈Silver

Claudetainer automates development workflows using Claude Code in devcontainers. It benefits developers and operations teams by streamlining code environments. It connects to devcontainer tools and workflows, enhancing productivity.

10570Updated 2mo ago

Intermediate30min to implementautomation

Saves ~15 min per use

Quick InstallView Source

git clone https://github.com/smithclay/claudetainer.git

Works with:

Claude

Overview

About This Skill

How to Use

1. **Initialize Claudetainer**: Run `claudetainer init --language [PROGRAMMING_LANGUAGE] --project [PROJECT_NAME]` in your project root to generate a devcontainer configuration. 2. **Customize Dependencies**: Edit the generated `.devcontainer/devcontainer.json` to add required dependencies (e.g., `"features": {"postgresql": "15"}`). 3. **Build the Container**: Execute `claudetainer build` to create the devcontainer. Use `--cache-from` to speed up rebuilds. 4. **Verify the Environment**: Run `claudetainer exec [TEST_COMMAND]` to validate the setup. Check logs in `.claudetainer/logs/` for errors. 5. **Iterate**: Update the devcontainer config as your project evolves. Use `claudetainer update` to pull the latest changes from the template. **Tips:** - Use `claudetainer status` to check container health before debugging. - For complex setups, break dependencies into reusable modules (e.g., `"features": {"node": "18", "postgres": "15"}`). - Store sensitive environment variables in `.env` files and reference them in `devcontainer.json` using `"remoteEnv": {"DATABASE_URL": "${localEnv:DATABASE_URL}"}`.

Setup & Installation

Quick Install

No install command available. Check the GitHub repository for manual installation instructions.

Alternative Install (Git Clone)

git clone https://github.com/smithclay/claudetainer

Requirements

Claude Code or compatible AI agent
Works with: Claude

Quick Start Guide

Install the Skill

Copy the install command above and run it in your terminal.

Open Your AI Agent

Launch Claude Code, Cursor, or your preferred AI coding agent.

Try It Out

Use the prompt template or examples below to test the skill.

Customize

Adapt the skill to your specific use case and workflow.

Usage Examples

Prompt Template

Use Claudetainer to automate the setup of a [PROGRAMMING_LANGUAGE] development environment in a devcontainer for [PROJECT_NAME]. Configure the devcontainer to include [DEPENDENCIES] and [TOOLS]. After setup, run [TEST_COMMAND] to verify the environment. Document any issues encountered in [LOG_FILE].

Example Output

### Claudetainer Environment Setup Report

**Project:** `acme-auth-service` (Node.js v18 + PostgreSQL)
**Devcontainer Configuration:**
- Base image: `mcr.microsoft.com/devcontainers/base:ubuntu`
- Dependencies: `node@18.17.1`, `npm@9.6.7`, `postgresql@15`, `docker@24.0.5`
- Tools: `git`, `curl`, `jq`, `docker-compose@2.20.3`
- VS Code extensions: `ESLint`, `Prettier`, `PostgreSQL`

**Setup Process:**
1. Claudetainer initialized the devcontainer using the `acme-auth-service/.devcontainer/devcontainer.json` template.
2. Container built successfully in 3m 42s (cached layers: 85% reused).
3. PostgreSQL service started automatically with user `devuser` and database `acme_auth`.
4. Node.js dependencies installed via `npm ci` (127 packages, 0 vulnerabilities).
5. Environment variables loaded from `.env.example` (missing values prompted for user input).

**Verification:**
```bash
$ npm run test:unit
 PASS  tests/unit/auth.service.test.js (5.2s)
  ✓ should validate JWT tokens (300ms)
  ✓ should hash passwords correctly (150ms)

Test Suites: 1 passed, 1 total
Tests:       2 passed, 2 total
```

**Issues Logged:**
- Warning: PostgreSQL `max_connections` set to default (100). Recommended to increase for CI environments.
- Note: VS Code extensions installed but not activated until workspace reload.

**Next Steps:**
- Run `npm run dev` to start the application locally.
- Configure `DATABASE_URL` in `.env` for persistent data.
- Push changes to `.devcontainer/devcontainer.json` to version control the configuration.

**Time Saved:** Estimated 45 minutes (manual setup time for a new developer).