Skip to content

Getting Started

Installation

go install github.com/jtieri/mold/cmd/mold@latest

Requires Go 1.25.7 or later. The binary is installed to $GOPATH/bin.

Build from source

git clone https://github.com/jtieri/mold.git
cd mold
make build    # Output: bin/mold

Verify

mold --version

Your first project

1. Create a project

mold new my-app --stack go

This creates a my-app/ directory with:

  • CLAUDE.md and .claude/settings.json -- Claude Code instruction files
  • .claude/commands/ -- slash commands for /review, /test, /doc, /refactor
  • docs/TODO.md -- task tracking template
  • go.mod, main.go, Makefile -- Go starter files
  • .repomixignore, repomix.config.json -- Repomix configuration
  • .gitignore -- language-appropriate ignores
  • An initialized git repository with an initial commit

2. Add more AI tools

Want Cursor and Copilot too?

mold new my-app --stack go --tools cursor,copilot

Or generate files for every supported tool:

mold new my-app --stack go --tools all

3. Start coding

cd my-app
claude    # Launch Claude Code with your project context

Adding mold to an existing project

Already have a project? Use mold init:

cd my-existing-project
mold init --tools cursor,aider

This adds AI config files without creating directories, running git init, or making commits. Use --force to overwrite existing files.

Interactive mode

Not sure what options to pick? Use the TUI wizard:

mold new -i

This walks you through project name, kit, stack, and tool selection interactively.

Try the Forge kit

For product-focused projects, the Forge kit provides a structured lifecycle from ideation to launch:

mold new my-product --kit forge --stack go

This creates a forge/ directory with eight phases (ideation, research, product definition, design, development, testing, launch, post-launch), along with 12 slash commands to guide you through each stage. See the generated FORGE-GUIDE.md for detailed usage.

Set defaults

Tired of typing the same flags? Save your preferences:

mold config set default-kit beads
mold config set default-stack go
mold config set tools claude,cursor,copilot
mold config set author "Your Name"

Now mold new my-app uses your saved defaults automatically.