claudetainer

Name: claudetainer
Author: smithclay

by smithclay

Verified

Easy Claude Code devcontainer workflows

105stars

8forks

Shell

Added 1/2/2026

Installation

# Add to your Claude Code skills
git clone https://github.com/smithclay/claudetainer

Getting Started

Guides for using ai agents skills like claudetainer.

Caveman: Cut Claude Token Use by 65%
How agent-side prompt compression works, when to use it, and when not to.
What is an AI Skills Marketplace?
Definitions, how marketplaces work, and how to choose between them in 2026.
Getting Started with AI Skills

Security ReportVerified

Last scanned: 5/30/2026

{
  "issues": [],
  "status": "PASSED",
  "scannedAt": "2026-05-30T16:57:27.065Z",
  "npmAuditRan": true,
  "pipAuditRan": true
}

README.md

Frequently Asked Questions

What is claudetainer?

claudetainer is an open-source ai agents skill for AI coding assistants such as Claude Code, Codex CLI, and ChatGPT, built by smithclay. Easy Claude Code devcontainer workflows. It has 105 GitHub stars.

Is claudetainer safe to use?

Yes. claudetainer passed SkillsLLM's automated security scan — a dependency vulnerability audit plus prompt-injection heuristics — with no high-severity issues. You can read the full report in the Security Report section on this page.

How do I install claudetainer?

Clone the repository with "git clone https://github.com/smithclay/claudetainer" and add it to your Claude Code skills directory (see the Installation section above).

What programming language is claudetainer written in?

claudetainer is primarily written in Shell. It is open-source under smithclay on GitHub, so you can review or fork the full source.

Are there alternatives to claudetainer?

Yes. SkillsLLM lists many other AI Agents skills you can browse and compare side by side. Open the AI Agents category from the badge at the top of this page, or use the Related Skills and comparison links further down to weigh claudetainer against similar tools.

Agentic AI for Beginners

Build your first AI agent from scratch - tool use, ReAct pattern, memory, deployment

41 minBeginner

Comments (0)

to leave a comment.

No comments yet. Be the first to share your thoughts!

Related Skills

superpowers

by obra

An agentic skills framework & software development methodology that works.

234,966

claude-cowork-linux cli-anything-wps

claudetainer 📦 🤖

March 2026 update: This is now obsoleted by Claude Code "Remote Control" capabilities.

October 2025 update: Claude Code is now available in research preview in Anthropic's iOS app with built-in sandboxing, this may be the official solution you're looking for :)

Auto-configured Claude Code devcontainer with mobile-friendly shell: code from anywhere.

Claude Code automatically configured with a persistent shell session, hooks, slash commands, utilities, and specialized sub-agents designed for coding without a keyboard. Everything runs in an isolated devcontainer using Anthropic's official image.

Quick Start (Recommended)

Get up and running in under 2 minutes on Linux, macOS or WSL:

# 1. Add the tap and install
brew tap smithclay/tap
brew install claudetainer

cd ~/your-project

# 2. Initialize your project with a language preset (go, node, python, rust)
claudetainer init python

# 3. Start the container
claudetainer up

# 4. Connect to the container with SSH key authentication (passwordless)
claudetainer ssh

# 5. (Inside the ssh session) Start Claude Code: all hooks and slash commands automatically load in a nice zellij UI.
claude

You now have a fully configured Claude Code development environment with specialized sub-agents, automated quality control, slash commands, and team workflows.

Why Claudetainer?

🚀 Instant Setup - Auto-detects your language (Python, Node.js, Go, Rust, Shell) and configures everything
📱 Code Anywhere - SSH + terminal multiplexer designed for mobile coding (yes, even from your iPhone)
🔧 Smart Tooling - Claude Code with specialized sub-agents, automatic quality control, and useful tools like ccusage and gitui
📬 Stay Connected - Push notifications so you know when Claude needs attention
🏗️ Team Ready - Share configurations via GitHub repos

Requirements

Docker - On macOS, using Docker Desktop is recommended
DevContainer CLI - npm install -g @devcontainers/cli

Installation

macOS & Linux (Recommended):

# Add the tap (one-time setup)
brew tap smithclay/tap
brew install claudetainer

# Install dependencies
brew install node
npm install -g @devcontainers/cli

Other systems: Direct download or dev container feature

Essential Commands

# Project setup
claudetainer init [language]    # Create a new devcontainer for your project
claudetainer up                 # Start container

# Connect and use
claudetainer ssh                # Connect with terminal multiplexer
claude                          # Start Claude Code (inside container)

# Management
claudetainer list               # List running containers
claudetainer doctor             # Health check and troubleshooting
claudetainer rm -f              # Clean removal

Remote Development

Connect from anywhere with persistent sessions:

claudetainer mosh                # MOSH + Zellij/tmux multiplexer (better for mobile)
# Uses SSH key authentication (passwordless)

Includes mobile-optimized layouts and push notifications so you can code from your phone effectively.

Advanced Configuration

GitHub Presets - Share team configurations
Custom Layouts - Terminal multiplexer customization
CLI Reference - Complete command documentation
Troubleshooting - Detailed problem solving

Contributing

Want to improve claudetainer? Check out our development guide for:

Architecture deep-dive
Creating new presets
Testing strategies
Contribution workflow

License

MIT License - see LICENSE for details.

Acknowledgements

Many of the original hooks and commands came from sources elsewhere in the Claude Code community, specificaly:

Huge thanks to both of those people.