FAQ

AgileBuilder frequently asked questions — pricing, account requirements, supported AI tools, template sources, offline use, data storage, and refunds

Product & pricing

Is AgileBuilder free?

There are two layers:

  • Open-source CLI: completely free, MIT-licensed open source. All local-space features — template management, project generation, variable rendering, Hooks, the MCP server — are free forever and need no account.
  • Cloud service: sign up and you can use the free tier (cloud spaces are read-only). Write access to cloud spaces (creating/editing resources) and team collaboration are subscription features. China region: ¥199/year (personal), ¥199/seat/year (team). Global region: $49/year, $49/user/year.

Do I need an account?

Not for local use. Working purely locally — ag create --git-url, managing local resources with ag res, running agilebuilder-mcp — requires no registration and no sign-in. You only need an SSO account for cloud spaces, multi-device sync, or team collaboration.

Does AgileBuilder call any LLM?

No. AgileBuilder neither integrates nor invokes any LLM. It manages your templates and standards documents and serves them to AI tools over the MCP protocol; the actual model calls happen on your AI tool's side (e.g. Cursor, Claude Code).

Usage

Which AI tools are supported?

Any client that supports MCP (Model Context Protocol) can integrate, including Cursor, Claude Code, and Codex. Configuration means adding agilebuilder-mcp as a stdio server in the client's MCP settings — see MCP Integration, Cursor Setup, and Claude Code Setup.

Where do templates come from?

Three sources:

  1. Your own Git repositories: any Git repository plus a .agilebuilder.config.yaml is a template — use it directly with ag create --git-url <url>; see Create a Template
  2. Team-shared template libraries: templates maintained centrally in a team space, available to members after sign-in
  3. The Resource Plaza: public templates listed on the website's Resource Plaza

Does it work offline?

Local-space features work fully offline: no sign-in required, and commands like create and res work as usual. Two exceptions: cloning a template requires access to its Git host, and accessing cloud spaces requires a network connection.

Where is my data stored?

  • The CLI's local data (config, current space, local resources, encrypted credentials) lives in ~/.agilebuilder/v2; you can relocate it with the AGILEBUILDER_CORE1_DATA_DIR environment variable
  • Cloud resources are stored on AgileBuilder Cloud servers, isolated per space; see the Privacy Policy for details

Accounts & subscriptions

Which sign-in methods are supported?

Pure SSO authentication with no standalone password: email verification code, WeChat scan, GitHub, and Google. First sign-in automatically creates your account and a personal space. On the CLI, ag login goes through browser-based OAuth; ag login --api-key <key> is also available.

What is the Trial?

Each account (space) can activate a 14-day Trial once, with full cloud write capability during the trial; team spaces are capped at 10 seats while trialing. After expiry the space returns to the free tier's read-only state — existing resources remain viewable and usable.

How do refunds work?

All paid orders are eligible for a refund within 14 days of payment, covering initial purchases, renewals, seat additions, and upgrades. See the Refund Policy for the process.

Which payment methods are supported?

The China region accepts WeChat Pay and Alipay; the Global region accepts PayPal and Paddle.

Next steps