CodeForge

Docker container management for development environments by Tulip Tree Technology.

Features

CodeForge is a VSCode extension that simplifies Docker container management directly from the command palette. It provides the following features:

• Initialize CodeForge: Set up CodeForge in your workspace
• Build Docker Environment: Build Docker containers for your development environment
• Launch Terminal in Container: Open a terminal session inside a running container
• Run Command in Container: Execute commands inside Docker containers
• Task Provider Integration: Run VSCode tasks inside Docker containers seamlessly

Usage

Open the Command Palette (Ctrl+Shift+P or Cmd+Shift+P on macOS) and type "CodeForge" to see all available commands.

Available Commands

1. CodeForge: Initialize CodeForge - Initialize CodeForge in your current workspace
2. CodeForge: Build Docker Environment - Build the Docker environment based on your configuration
3. CodeForge: Launch Terminal in Container - Open an interactive terminal in a Docker container
4. CodeForge: Run Command in Container - Run a specific command inside a Docker container

Task Provider

CodeForge includes a VSCode Task Provider that allows you to run commands inside Docker containers. This integrates seamlessly with VSCode's task system.

Important: Task Configuration Required

CodeForge no longer provides default tasks. You MUST configure your own tasks in .vscode/tasks.json with the required "command" property that specifies what to run in the Docker container.

Using Tasks

1. Configure Tasks: Create a .vscode/tasks.json file with your CodeForge task definitions (required)
2. Execute Tasks: Run tasks via Terminal → Run Task or keyboard shortcuts (Ctrl+Shift+B for build)
3. View Output: Command output is captured in the CodeForge output window (View → Output → CodeForge)

Example Task Definition

Create a .vscode/tasks.json file in your project with the required "command" property:

{
  "version": "2.0.0",
  "tasks": [
    {
      "type": "codeforge",
      "label": "Run in Container: Build",
      "command": "make build", // REQUIRED: Command to execute
      "detail": "Builds the project in Docker container",
      "group": {
        "kind": "build",
        "isDefault": true
      }
    },
    {
      "type": "codeforge",
      "label": "Run in Container: Test",
      "command": "npm test", // REQUIRED: Command to execute
      "detail": "Runs tests in Docker container",
      "group": {
        "kind": "test",
        "isDefault": true
      }
    },
    {
      "type": "codeforge",
      "label": "Run in Container: Dev Server",
      "command": "npm run dev", // REQUIRED: Command to execute
      "detail": "Starts development server in Docker container"
    }
  ]
}

Note: The "command" property is required for all tasks. Without it, the task will fail.

For comprehensive examples and detailed documentation, see Task Provider Documentation and Example Tasks.

Requirements

• Visual Studio Code v1.74.0 or higher
• Docker installed and running on your system

Installation

This extension is currently in development. To install:

1. Clone this repository
2. Open in Visual Studio Code
3. Run the extension in development mode (F5)

Configuration

CodeForge can be configured through VSCode settings:

• codeforge.dockerCommand: The Docker command to use (default: "docker")
• codeforge.removeContainersAfterRun: Automatically remove containers after they exit (default: true)
• codeforge.additionalDockerRunArgs: Additional arguments to pass to docker run commands (default: [])
• codeforge.showOutputChannel: Automatically show the output channel when running commands (default: true)
• codeforge.defaultShell: Default shell to use in containers (default: "/bin/bash")
• codeforge.mountWorkspace: Automatically mount the workspace directory in containers (default: true)

Release Notes

0.0.1

Initial release of CodeForge with basic command structure.

Contributing

Contributions are welcome! Please feel free to submit a Pull Request.

License

This extension is licensed under the MIT License. See the LICENSE file for details.

About

CodeForge is developed and maintained by Tulip Tree Technology.