MetaGPT/.devcontainer/README.md

# Dev container

This project includes a [dev container](https://containers.dev/), which lets you use a container as a full-featured dev
environment.

You can use the dev container configuration in this folder to build and start running MetaGPT locally! For more, refer
to the main README under the home directory.
You can use it in [GitHub Codespaces](https://github.com/features/codespaces) or
the [VS Code Dev Containers extension](https://marketplace.visualstudio.com/items?itemName=ms-vscode-remote.remote-containers).

## GitHub Codespaces

<a href="https://codespaces.new/geekan/MetaGPT"><img src="https://github.com/codespaces/badge.svg" alt="Open in GitHub Codespaces"></a>

You may use the button above to open this repo in a Codespace

For more info, check out
the [GitHub documentation](https://docs.github.com/en/free-pro-team@latest/github/developing-online-with-codespaces/creating-a-codespace#creating-a-codespace).

## VS Code Dev Containers

<a href="https://vscode.dev/redirect?url=vscode://ms-vscode-remote.remote-containers/cloneInVolume?url=https://github.com/geekan/MetaGPT"><img src="https://img.shields.io/static/v1?label=Dev%20Containers&message=Open&color=blue&logo=visualstudiocode" alt="Open in Dev Containers"></a>

Note: If you click this link you will open the main repo and not your local cloned repo, you can use this link and
replace with your username and cloned repo name:
https://vscode.dev/redirect?url=vscode://ms-vscode-remote.remote-containers/cloneInVolume?url=https://github.com/geekan/MetaGPT

If you already have VS Code and Docker installed, you can use the button above to get started. This will cause VS Code
to automatically install the Dev Containers extension if needed, clone the source code into a container volume, and spin
up a dev container for use.

You can also follow these steps to open this repo in a container using the VS Code Dev Containers extension:

1. If this is your first time using a development container, please ensure your system meets the pre-reqs (i.e. have
   Docker installed) in the [getting started steps](https://aka.ms/vscode-remote/containers/getting-started).

2. Open a locally cloned copy of the code:

    - Fork and Clone this repository to your local filesystem.
    - Press <kbd>F1</kbd> and select the **Dev Containers: Open Folder in Container...** command.
    - Select the cloned copy of this folder, wait for the container to start, and try things out!

You can learn more in the [Dev Containers documentation](https://code.visualstudio.com/docs/devcontainers/containers).

## Tips and tricks

* If you are working with the same repository folder in a container and Windows, you'll want consistent line endings (
  otherwise you may see hundreds of changes in the SCM view). The `.gitattributes` file in the root of this repo will
  disable line ending conversion and should prevent this.
  See [tips and tricks](https://code.visualstudio.com/docs/devcontainers/tips-and-tricks#_resolving-git-line-ending-issues-in-containers-resulting-in-many-modified-files)
  for more info.
* If you'd like to review the contents of the image used in this dev container, you can check it out in
  the [devcontainers/images](https://github.com/devcontainers/images/tree/main/src/python) repo.