How Factorly works
Factorly isn't a code generator that hands you a wall of text. It's an agent — a model that uses tools to do real work in a real project, the same way a developer would.
The agent loop
When you send a message, the agent runs a loop until your request is done:
- Read — it inspects the relevant files to understand the current state of your project.
- Plan — it decides what to change.
- Act — it writes and edits files, and runs commands (installing dependencies, running the dev server, running your tests).
- Observe — it reads the output of those commands and the running app.
- Correct — if something failed, it reads the error and fixes it, then loops again.
It keeps going through that cycle on its own until the task is complete — you don't have to nudge it through each step.
Everything is streamed
Nothing happens in a black box. As the agent works, you see each action stream in live:
- the files it reads and writes (with the diff),
- the exact commands it runs,
- the command output, including errors,
- and its reasoning along the way.
If you ever wonder why it did something, the answer is right there in the transcript.
It checks its own work
The thing that makes the agent feel reliable is that it verifies. After making a change it will typically build the project or run it and read the result. A failing build or a runtime error isn't the end of the turn — it's information the agent uses to fix the problem and try again.
Checkpoints keep you safe
Every agent turn ends in a checkpoint — a real git commit of your project at that moment. That means:
- your history is a clean timeline of working states,
- you can roll back to any earlier checkpoint in one click,
- and you never have to fear experimenting, because nothing is ever lost.
Read more in Checkpoints and rollback.
It's a real project
Under the hood, your app is a normal codebase with a real toolchain and real git history — not a proprietary format. You can open the file tree and editor, drop into a terminal, and export everything to GitHub whenever you want.
Ready to build? Head to the Quickstart, or learn your way around the workspace.