AgileBuilder logoAgileBuilder
Back to docs

FAQ

AgileBuilder frequently asked questions

Basics

What is AgileBuilder?

AgileBuilder is a scaffolding tool for the AI era. It provides project generation based on templates and can map your team's documentation as MCP resources, enabling AI to follow your team's standards.

Is AgileBuilder free?

Local is completely free to use. Online offers Pro and Team subscriptions with more advanced features.

What platforms does AgileBuilder support?

AgileBuilder supports Windows, macOS, and Linux. The CLI tool runs in any environment with Node.js installed.

Local vs Online

What's the difference between Local and Online?

Main differences:

  • Data Storage: Local stores data locally, Online syncs to the cloud
  • Team Collaboration: Local doesn't support collaboration, Online does
  • Multi-device Sync: Local doesn't support it, Online does

Where is local data stored?

Local data is stored in the ~/.agilebuilder directory.

Templates

How do I create a template?

See the Template Getting Started guide.

Can I convert an existing project to a template?

Yes! Use the agilebuilder template create command to quickly create a template from an existing project.

What variable types do templates support?

Four variable types are supported:

  • string - String
  • boolean - Boolean
  • select - Single select
  • multiselect - Multi select

See the Variables Reference for details.

AI Integration

What is MCP?

MCP (Model Context Protocol) is a standard protocol that allows AI tools to interact with AgileBuilder.

Which AI tools are supported?

Currently supports Cursor, Claude Code, Windsurf, and more. See AI Tool Compatibility.

How do I configure MCP?

See the MCP Service Configuration guide.

Team Collaboration

How do I create a team?

After logging into the console, click Create Team to get started.

How do I invite members?

In team settings, click Invite Member and enter the email address.

What's the member limit for Team plan?

Team plan supports up to 50 members.

Subscriptions

How do I subscribe?

See the Subscription guide.

Can I get a refund?

Yes, you can request a full refund within 7 days of your subscription start date if you're not satisfied. See Refund Policy.

How do I get an invoice?

Request an invoice in Account Settings > Subscription.

Troubleshooting

Installation failed

Make sure Node.js version >= 18.0. Check with:

node --version

Template generation failed

Common causes:

  1. Invalid variable syntax in template files
  2. Missing required variables
  3. Output directory already exists and is not empty

Use --verbose to see detailed error messages:

agilebuilder generate <template> <output> --verbose

MCP connection failed

  1. Make sure MCP service is running: agilebuilder mcp status
  2. Check if port configuration is correct
  3. Check firewall settings

Other Questions

How do I contact support?

How do I submit feature requests?

We welcome feature requests on GitHub Issues.