Skip to main content

devs - DevContainer Management Tool

A Python command-line tool that simplifies managing multiple named devcontainers for any project.

Features

  • Multiple Named Containers: Start multiple devcontainers with custom names (e.g., "sally", "bob", "charlie")
  • VS Code Integration: Open containers in separate VS Code windows with clear titles
  • Project Isolation: Containers are prefixed with git repository names (org-repo format)
  • Environment Variable Management: Layered DEVS.yml configuration with user-specific overrides
  • Shared Authentication: Claude credentials are shared between containers for the same project
  • Cross-Platform: Works on any project with devcontainer configuration

Installation

pip install devs

Usage

# Start development environments
devs start frontend backend

# Open both in VS Code (separate windows)
devs vscode frontend backend

# Work in a specific container
devs shell frontend

# Run Claude in a container
devs claude frontend "Summarize this codebase"

# Run tests in a container
devs runtests frontend

# Environment variables support
devs start frontend --env DEBUG=true --env API_URL=http://localhost:3000
devs claude frontend "Fix the tests" --env NODE_ENV=test

# Set up Claude authentication (once per host)
devs claude --auth
# Or with API key
devs claude --auth --api-key <YOUR_API_KEY>

# Clean up when done
devs stop frontend backend

# List active containers
devs list

Configuration

Environment Variables

devs supports layered environment variable configuration through DEVS.yml files:

Priority order (highest to lowest):

  1. CLI --env flags
  2. ~/.devs/envs/{org-repo}/DEVS.yml (user-specific project overrides)
  3. ~/.devs/envs/default/DEVS.yml (user defaults)
  4. {project-root}/DEVS.yml (repository configuration)

Example DEVS.yml in your project:

env_vars:
  default:
    NODE_ENV: development
    API_URL: https://api.example.com
    DEBUG: "false"
  
  frontend:  # Container-specific overrides
    DEBUG: "true"
    FRONTEND_PORT: "3000"
    
  backend:
    NODE_ENV: production
    API_URL: https://prod-api.example.com

User-specific configuration:

# Global user defaults
mkdir -p ~/.devs/envs/default
echo 'env_vars:
  default:
    GLOBAL_SETTING: "user_preference"
    MY_SECRET: "user_secret"' > ~/.devs/envs/default/DEVS.yml

# Project-specific overrides (org-repo format)
mkdir -p ~/.devs/envs/myorg-myproject
echo 'env_vars:
  frontend:
    DEBUG: "true"
    LOCAL_SECRET: "dev_secret"' > ~/.devs/envs/myorg-myproject/DEVS.yml

📖 See ../../example-usage.md for detailed examples and scenarios

Requirements

  • Docker: Container runtime
  • VS Code: With code command in PATH
  • DevContainer CLI: npm install -g @devcontainers/cli
  • Project Requirements: .devcontainer/devcontainer.json in target projects

Architecture

Container Naming

Containers follow the pattern: dev-<org>-<repo>-<dev-name>

Example: dev-ideonate-devs-sally, dev-ideonate-devs-bob

VS Code Window Management

Each container gets unique workspace paths to ensure VS Code treats them as separate sessions.

Claude Authentication Sharing

The tool creates symlinks so all containers for the same project share Claude authentication.

Development

# Clone repository
git clone https://github.com/ideonate/devs.git
cd devs/python-devs

# Install in development mode
pip install -e ".[dev]"

# Run tests
pytest

# Format code
black devs tests

# Type checking
mypy devs

License

MIT License

Metadata

Release files for devs-cli 6.0.1

For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.

Source distribution (sdist)

Source distribution for devs-cli 6.0.1
File Size Uploaded Provenance Actions
devs_cli-6.0.1.tar.gz 41.5 kB With provenance Details for devs_cli-6.0.1.tar.gz

Built distribution (wheel)

Table of built distributions (wheels) for devs-cli 6.0.1
File Interpreter ABI Platform Actions
devs_cli-6.0.1-py3-none-any.whl Python 3 none any Details for devs_cli-6.0.1-py3-none-any.whl

Total release size: 62.5 kB

Release files / devs_cli-6.0.1.tar.gz

Download URL devs_cli-6.0.1.tar.gz
Size 41.5 kB
Tags Source
SHA-256 checksum
How to use checksums
ce6363c9fbe04840131ef84cf178a8514406615a94be9deaa8d4f6715cf32e50
BLAKE2b-256 checksum
How to use checksums
4bc64ce8e4045d3fc74feebecebcdb3dd4d4c9d45be272da6183dbff0614c27c
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
Yes
Uploaded via twine/7.0.0 CPython/3.13.14

Provenance

Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.

PyPI Publish Attestation

PyPI verified that this artifact, at this checksum, originated from the publisher listed below.

Signed by GitHub Actions, verified by PyPI on Oct 15, 2026.

Transparency log

Release files / devs_cli-6.0.1-py3-none-any.whl

Download URL devs_cli-6.0.1-py3-none-any.whl
Size 21.0 kB
Tags Python 3
SHA-256 checksum
How to use checksums
72a46788444591046fc239a8ac9e23ddb8896f74f3f2ab3728ac029b2582afcf
BLAKE2b-256 checksum
How to use checksums
f086bc64dc5d60a47f5e7cda61d3d7f40d4e5cf4b4a4a0b9ee5ff65c2df3befa
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
Yes
Uploaded via twine/7.0.0 CPython/3.13.14

Provenance

Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.

PyPI Publish Attestation

PyPI verified that this artifact, at this checksum, originated from the publisher listed below.

Signed by GitHub Actions, verified by PyPI on Oct 15, 2026.

Transparency log

Security for devs-cli 6.0.1

Provenance

Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.

Full provenance

Both files in this release have been uploaded with provenance metadata.

Select from 2 files

Attestation for devs_cli-6.0.1.tar.gz

PyPI Publish Attestation

PyPI verified that this artifact, at this checksum, originated from the publisher listed below.

Signed by GitHub Actions, verified by PyPI on Oct 15, 2026.

Transparency log

A note on package security

PyPI is a repository for distributing packages, not a service for auditing them. While third-party security researchers and our staff do their best to detect and remove malicious packages, PyPI cannot guarantee the quality, security or suitability of any given package.

To learn more about protecting yourself from malicious actors, visit our package security documentation.

Release history Release notifications | RSS feed

This release

6.0.1 This release

2 release files Full provenance

Anthropic, PBC Visionary sponsor Bloomberg Visionary sponsor Hudson River Trading Visionary sponsor Meta Visionary sponsor NVIDIA Visionary sponsor Microsoft Sustainability sponsor Depot Continuous Integration AWS Cloud computing and Security Sponsor Datadog Monitoring Fastly CDN Google Download Analytics Sentry Error logging StatusPage Status page