Makiaveli · docs

Documentation

Last updated April 24, 2026

Getting started with Makiaveli

Makiaveli turns a chat into a working web app. You describe what you want, an AI agent drafts a plan, and the code is written in front of you while a real in-browser bundler compiles the preview.

The core loop

Create a project — open the dashboard and click New Project. Write a description of what you want to build. When you hit Create, an auto-plan is generated server-side and waiting for you when the editor opens.
Review the plan — the plan card in the chat lists 3–12 discrete steps the agent will execute. You can approve the whole plan, reject it, or switch to chat mode and refine.
Watch it build — the preview pane shows a live build animation while the agent writes files. Each step ticks off in the plan card.
Iterate — once the build is done, keep chatting. Every AI turn is snapshotted so you can revert.
Publish — click Deploy in the top bar to get a shareable /p/[slug] URL.

Chat modes

Chat — read-only Q&A. The agent explains code but never touches files. Use this when you want to understand what was built.
Plan — drafts a plan first, waits for your approval, then executes. The default for new projects.
Agent — auto-plans AND auto-executes without manual approval. For when you're confident.

Credits

Billing uses credits, not dollars. 1 credit = $0.20, so $20 buys 100 credits. Each AI request charges micro-amounts based on actual token usage + a platform markup. Top up anytime from the Billing page, or upgrade to a subscription tier for monthly allowance and feature unlocks.

Per-project databases

If you connect your Supabase project in Settings, every Makiaveli project gets its own isolated Postgres schema (for example proj_my_app_a3f912). The editor's Database tab only shows tables from that schema — your apps never see each other's data.

Remixing

Any published site on Makiaveli has a Remix button. Click it to get your own copy of the project in your account, then keep building on top of it. Remixing is free on every tier.

Need more?

/community — Discord + GitHub Discussions
/support — email us with a specific question
/changelog — release notes and new features

The core loop

Create a project — open the dashboard and click New Project. Write a description of what you want to build. When you hit Create, an auto-plan is generated server-side and waiting for you when the editor opens.

Review the plan — the plan card in the chat lists 3–12 discrete steps the agent will execute. You can approve the whole plan, reject it, or switch to chat mode and refine.

Watch it build — the preview pane shows a live build animation while the agent writes files. Each step ticks off in the plan card.

Iterate — once the build is done, keep chatting. Every AI turn is snapshotted so you can revert.

Publish — click Deploy in the top bar to get a shareable /p/[slug] URL.

Chat modes

Chat — read-only Q&A. The agent explains code but never touches files. Use this when you want to understand what was built.

Plan — drafts a plan first, waits for your approval, then executes. The default for new projects.

Agent — auto-plans AND auto-executes without manual approval. For when you're confident.