### Install Dependencies and Build Project

Source: https://github.com/drhalto/agentmako/blob/main/CONTRIBUTING.md

Installs project dependencies using pnpm and builds the project. This is the initial setup step.

```bash
corepack pnpm install
corepack pnpm run build
```

--------------------------------

### Install and Build Agentmako CLI

Source: https://github.com/drhalto/agentmako/blob/main/START_HERE.md

Installs dependencies, builds the project, and connects to the CLI without a database.

```bash
corepack pnpm install
corepack pnpm run build
node apps/cli/dist/index.js connect . --no-db
```

--------------------------------

### Install Agentmako CLI (Global)

Source: https://github.com/drhalto/agentmako/blob/main/apps/cli/README.md

Install the Agentmako CLI globally using npm and then run the connect command.

```bash
npm install -g agentmako
agentmako connect
```

--------------------------------

### Install Agentmako CLI (One-off)

Source: https://github.com/drhalto/agentmako/blob/main/apps/cli/README.md

Run the Agentmako CLI without a global installation using npx.

```bash
npx agentmako connect
```

--------------------------------

### Launch Local Dashboard

Source: https://github.com/drhalto/agentmako/blob/main/START_HERE.md

Starts the agentmako local dashboard for visualization and interaction.

```bash
node apps/cli/dist/index.js dashboard .
```

--------------------------------

### Start Agentmako Web Server

Source: https://github.com/drhalto/agentmako/blob/main/test/README.md

Starts the Agentmako web server on a specified port. This server hosts the user interface that interacts with the API server.

```bash
node apps/web/scripts/serve.mjs 4174
```

--------------------------------

### Clone and Build Agentmako from Source

Source: https://github.com/drhalto/agentmako/blob/main/README.md

Set up a development environment by cloning the repository, installing dependencies, building the project, and linking the CLI.

```bash
git clone https://github.com/drhalto/agentmako.git
cd agentmako
corepack pnpm install
corepack pnpm run build
npm link ./apps/cli
```

--------------------------------

### Start Local Supabase Stack

Source: https://github.com/drhalto/agentmako/blob/main/test/README.md

Commands to manage the local Supabase instance for integration testing.

```bash
# Start the local stack
corepack pnpm run supabase:start

# Rebuild the local database from migrations + seed data
corepack pnpm run supabase:reset

# Inspect local URLs and keys
corepack pnpm run supabase:status
```

--------------------------------

### Start Agentmako API Server

Source: https://github.com/drhalto/agentmako/blob/main/test/README.md

Starts the Agentmako API server on a specified port. This is the first step for manual web client testing, allowing the web client to connect to the backend.

```bash
node apps/cli/dist/index.js serve 3020
```

--------------------------------

### Install Mako AI Plugin

Source: https://github.com/drhalto/agentmako/blob/main/plugins/cursor/README.md

Installs the Mako AI plugin by creating a symbolic link in the Cursor plugins directory. Ensure you are in the repository root when running this command.

```bash
mkdir -p ~/.cursor/plugins/local
ln -s "$(pwd)/plugins/cursor" ~/.cursor/plugins/local/mako-ai
```

--------------------------------

### Install Mako AI Plugin for Codex

Source: https://github.com/drhalto/agentmako/blob/main/plugins/codex/README.md

Install the Mako AI plugin from the repository root using the codex marketplace add command.

```bash
codex marketplace add ./plugins
```

--------------------------------

### PowerShell Smoke Test Example

Source: https://github.com/drhalto/agentmako/blob/main/test/README.md

Example of setting the database URL environment variable and running smoke tests in PowerShell.

```powershell
$env:MAKO_TEST_DATABASE_URL = "postgresql://postgres:postgres@127.0.0.1:54322/postgres"
corepack pnpm run test:smoke
```

--------------------------------

### Launch Agentmako Dashboard

Source: https://github.com/drhalto/agentmako/blob/main/README.md

Starts the Agentmako local API, harness service, and web dashboard from within the target project directory.

```bash
agentmako dashboard .
```

--------------------------------

### Connect Agentmako with Database (Interactive)

Source: https://github.com/drhalto/agentmako/blob/main/README.md

Initiates an interactive setup to connect Agentmako to a database, storing secrets in the OS keychain.

```bash
agentmako connect .
```

--------------------------------

### Install Mako AI Gemini Extension

Source: https://github.com/drhalto/agentmako/blob/main/plugins/gemini/README.md

Install the Mako AI extension for Gemini CLI from the repository root. This command enables Mako skills and MCP server wiring.

```bash
gemini extensions install ./plugins/gemini
```

--------------------------------

### Attach and Index Project

Source: https://github.com/drhalto/agentmako/blob/main/README.md

Connects Agentmako to the current project for analysis. Use --no-db for the initial setup to establish code intelligence paths before database integration.

```bash
agentmako connect . --no-db
```

--------------------------------

### Connect Agentmako with Database (Scripted)

Source: https://github.com/drhalto/agentmako/blob/main/README.md

Connects Agentmako to a database using a DATABASE_URL environment variable for CI or scripted setup. Includes a --yes flag for non-interactive confirmation.

```bash
set DATABASE_URL=postgres://...
agentmako connect . --db-env DATABASE_URL --yes
```

--------------------------------

### Connect to Project

Source: https://github.com/drhalto/agentmako/blob/main/apps/cli/README.md

Initiate the project connection process, which includes indexing code and schema sources, optionally connecting a live database, and refreshing schema snapshots.

```bash
agentmako connect
```

--------------------------------

### Build and Run Web Client

Source: https://github.com/drhalto/agentmako/blob/main/apps/web/README.md

Commands to build the web client using corepack pnpm and then serve it locally with Node.js.

```bash
corepack pnpm build
```

```bash
node apps/web/scripts/serve.mjs
```

--------------------------------

### Rule pack example for helper canonicality

Source: https://github.com/drhalto/agentmako/blob/main/docs/reef-engine.md

Example of a rule pack expressing a primitive cross-file helper-canonicality rule. It defines a pattern to find a suspect AST shape and specifies the canonical helper that should own that behavior.

```yaml
rules:
  - id: courseconnect.auth.helper_bypass
    category: rpc_helper_reuse
    severity: high
    confidence: confirmed
    languages: [ts]
    message: Direct profiles query should go through enforceAccountStatus.
    pattern: $CLIENT.from("profiles")
    canonicalHelper:
      symbol: enforceAccountStatus
      path: lib/auth/dal.ts
```

--------------------------------

### List Available Tools

Source: https://github.com/drhalto/agentmako/blob/main/START_HERE.md

Lists the tools available through the agentmako CLI.

```bash
node apps/cli/dist/index.js tool list
```

--------------------------------

### Mako Help Task Definition

Source: https://github.com/drhalto/agentmako/blob/main/AGENTS.md

Define a task for 'mako_help' to get a recipe with suggested arguments and verification steps for auditing.

```json
{
  "task": "audit auth flow for tenant-scoped dashboard role checks",
  "focusFiles": ["app/dashboard/layout.tsx"],
  "changedFiles": ["app/dashboard/layout.tsx"]
}
```

--------------------------------

### Confirm Agentmako CLI Availability

Source: https://github.com/drhalto/agentmako/blob/main/README.md

Verifies that the Agentmako CLI is installed and accessible by checking its version and running a diagnostic command.

```bash
agentmako --version
agentmako doctor
```

--------------------------------

### One-time Project Attach for Indexing

Source: https://github.com/drhalto/agentmako/blob/main/llms-install.md

Run this command to attach and index your project for agentmako. Use `--no-db` for the initial run. Subsequent runs can be interactive or configured for Postgres/Supabase.

```bash
npx agentmako connect /absolute/path/to/your/project --no-db
```

--------------------------------

### Generate and Add New Plugin Layouts

Source: https://github.com/drhalto/agentmako/blob/main/README.md

Demonstrates commands for validating, adding, and linking new Agentmako plugin layouts for different AI models (Claude, Gemini).

```bash
claude plugin validate ./plugins/claude-code
codex marketplace add ./plugins
ln -s "$(pwd)/plugins/cursor" ~/.cursor/plugins/local/mako-ai
gemini extensions install ./plugins/gemini
```