Initialize

Set up the shell environment in a specified project directory, configure initial files, and define mode (wcgw, architect, code-writer) for MCP server interactions. Use to start, reset, or switch workspaces and modes.

Instructions

Always call this at the start of the conversation before using any of the shell tools from wcgw.
Use any_workspace_path to initialize the shell in the appropriate project directory.
If the user has mentioned a workspace or project root or any other file or folder use it to set any_workspace_path.
If user has mentioned any files use initial_files_to_read to read, use absolute paths only (~ allowed)
By default use mode "wcgw"
In "code-writer" mode, set the commands and globs which user asked to set, otherwise use 'all'.
Use type="first_call" if it's the first call to this tool.
Use type="user_asked_mode_change" if in a conversation user has asked to change mode.
Use type="reset_shell" if in a conversation shell is not working after multiple tries.
Use type="user_asked_change_workspace" if in a conversation user asked to change workspace

Input Schema

Name	Required	Description
`any_workspace_path`	Yes	Workspce to initialise in. Don't use ~ by default, instead use empty string
`code_writer_config`	No
`initial_files_to_read`	Yes
`mode_name`	Yes
`task_id_to_resume`	Yes
`thread_id`	Yes	Use the thread_id created in first_call, leave it as empty string if first_call
`type`	Yes

Input Schema (JSON Schema)

{
  "$defs": {
    "CodeWriterMode": {
      "additionalProperties": false,
      "properties": {
        "allowed_commands": {
          "anyOf": [
            {
              "const": "all",
              "type": "string"
            },
            {
              "items": {
                "type": "string"
              },
              "type": "array"
            }
          ]
        },
        "allowed_globs": {
          "anyOf": [
            {
              "const": "all",
              "type": "string"
            },
            {
              "items": {
                "type": "string"
              },
              "type": "array"
            }
          ]
        }
      },
      "required": [
        "allowed_globs",
        "allowed_commands"
      ],
      "type": "object"
    }
  },
  "additionalProperties": false,
  "properties": {
    "any_workspace_path": {
      "description": "Workspce to initialise in. Don't use ~ by default, instead use empty string",
      "type": "string"
    },
    "code_writer_config": {
      "anyOf": [
        {
          "$ref": "#/$defs/CodeWriterMode"
        },
        {
          "type": "null"
        }
      ],
      "default": null
    },
    "initial_files_to_read": {
      "items": {
        "type": "string"
      },
      "type": "array"
    },
    "mode_name": {
      "enum": [
        "wcgw",
        "architect",
        "code_writer"
      ],
      "type": "string"
    },
    "task_id_to_resume": {
      "type": "string"
    },
    "thread_id": {
      "description": "Use the thread_id created in first_call, leave it as empty string if first_call",
      "type": "string"
    },
    "type": {
      "enum": [
        "first_call",
        "user_asked_mode_change",
        "reset_shell",
        "user_asked_change_workspace"
      ],
      "type": "string"
    }
  },
  "required": [
    "type",
    "any_workspace_path",
    "initial_files_to_read",
    "task_id_to_resume",
    "mode_name",
    "thread_id"
  ],
  "type": "object"
}

mcp-wcgw

Initialize

Instructions

Input Schema

Input Schema (JSON Schema)

Other Tools from mcp-wcgw

Related Tools

MCP directory API