# Build with AI from your terminal

> The flowmaps command hands your features to an AI coding agent (Claude Code) and keeps your board up to date while it builds. You don't need to know progra

Canonical: https://flowmaps.app/docs/command-line

Build

# Build with AI from your terminal

Last updated: October 2026

The `flowmaps` command hands your features to an AI coding agent ([Claude Code](https://claude.com/claude-code)) and keeps your board up to date while it builds. You don't need to know programming or git: the command asks simple questions and takes care of the rest.

## What's a terminal?

A window where you type commands instead of clicking.

- **Windows:** press Start, type _PowerShell_ and press Enter.
- **Mac:** press ⌘ + Space, type _Terminal_ and press Enter.

## Set it up once

The same steps are in Flowmaps under **Settings → Build with AI from your terminal**, with copy buttons.

1. **Install Node.js.** Download the _LTS_ version from [nodejs.org](https://nodejs.org) and install it like any other program.
2. **Install the Flowmaps command.** Copy the install command from Settings and paste it into your terminal.
3. **Connect your computer.** Copy the `flowmaps login` command from Settings into your terminal. Your browser opens and shows a code. Check that it matches the code in your terminal, tick the box to confirm it's you, then click **Connect**. That's it: no passwords or keys to copy.
4. **Install Claude Code**, the AI that writes the code, from [claude.com/claude-code](https://claude.com/claude-code). Flowmaps tells you if it's missing.

## Build a feature

1. On your venture's **Board**, drag a feature to **Ready**, and make sure it has build prompts (open it, then _Build prompts → Generate_).
2. In the terminal, go to your project's folder, or any empty folder for a new project, and type:  
```  
flowmaps  
```
3. Choose **Build a feature** and pick one from the list.

The first time, Flowmaps asks which venture the folder is for, and remembers it. If you're in your home folder, it offers to create a project folder for you.

Then it:

- **turns on git** for your project if it isn't yet, after asking you. Git keeps a history, so you can always undo what the AI changes.
- **saves a checkpoint** of your current work first, after asking you.
- **works on a separate copy** of your project (a git _branch_), so your main project stays safe while the AI builds.
- **moves the feature to In Progress** on your board.
- **starts Claude Code**, which builds the feature and explains what it does in plain words.

**Tip:** every Ready feature in Flowmaps shows the exact command for it: open the card, and under _Build it in Claude Code_ click **Prefer the terminal?** to see a command like `flowmaps build v0.1.0`.

\~/pawstep $ flowmaps

Which feature do you want to build?

 1\. Customers pay in the app (v0.3.0)

✓ Working on a separate copy, so your project stays safe.

✓ "Customers pay in the app" is now In Progress.

Claude Code will now build it. It explains what it does as it goes.

## Finish a feature

When you're happy with the result, type `flowmaps` and choose **Finish a feature**, or type `flowmaps done`. Flowmaps:

1. saves the AI's work,
2. asks: _"Add it to your main project now?"_ and adds it when you say yes,
3. moves the feature to **Shipped** on your board,
4. reminds you to write a help article for it in your [knowledge base](https://flowmaps.app/docs/knowledge-base).

If the AI's changes clash with other changes in your project, nothing is merged and your work stays safe. Flowmaps tells you what to ask Claude Code to fix it.

## Features that follow git

While a feature is being built from the terminal, it **follows git**: it shows a small git icon on your board, and you can't drag it by hand (hover over it to see why). Finish it with `flowmaps done`. Changed your mind? `flowmaps unlink` lets you move it by hand again.

## All commands

Typing just `flowmaps` opens a menu with the common ones. You can also type them directly:

| Command         | What it does                                               |
| --------------- | ---------------------------------------------------------- |
| flowmaps        | Menu: build, finish, see your features, open Flowmaps      |
| flowmaps login  | Connect this computer (confirm in your browser)            |
| flowmaps build  | Pick a Ready feature and let the AI build it               |
| flowmaps done   | Add a finished feature to your project and mark it Shipped |
| flowmaps list   | See which features are ready or being built                |
| flowmaps unlink | Let a feature be moved by hand again                       |
| flowmaps whoami | Which account this computer uses                           |
| flowmaps logout | Disconnect this computer                                   |

Options for `build`: `--print` only shows the instructions and changes nothing; `--scope backend` builds one part only (`database`, `backend` or `frontend`); `--agent codex` uses another agent; `--no-branch` skips git branches; `--no-launch` saves the instructions without starting the agent.

## Disconnect a computer

In **Settings → Connected computers**, click **Disconnect** next to a computer you no longer use. The `flowmaps` command on that computer stops working until you connect it again.

## Example

You type `flowmaps` in your new, empty folder _pawstep_:

```
Flowmaps · Pawstep

What would you like to do?
   1. Build a feature
   2. Finish a feature (add it to my project)
   ...
Type a number (1-5): 1

Which feature do you want to build?
   1. Customers can book a walk (Pawstep, v0.1.0)
   2. Walkers have a profile (Pawstep, v0.2.0)
Type a number (1-2): 1

This folder doesn't use git yet. Git keeps a history of your project, so you can always undo what the AI changes.
Turn it on for this folder? [Y/n]
✓ Git is on.
✓ Working on a separate copy (git branch flowmaps/v0.1.0-customers-can-book-a-walk), so your main project stays safe.
✓ "Customers can book a walk" is now In Progress on your board.

Claude Code will now build "Customers can book a walk". It explains what it does as it goes.

```

Claude Code builds the booking page. You try it, you're happy, and you type `flowmaps done`. The feature is added to your project and moves to Shipped. 🎉

[← PreviousUse Flowmaps inside ChatGPT](https://flowmaps.app/docs/chatgpt-connection)[Next →Build several features at once](https://flowmaps.app/docs/build-several)

Try it on your own app idea

Flowmaps is free to start, and new accounts get 7 days of Pro. No credit card.

[Start free](https://flowmaps.app/login?new=1)
