Halfcycle is a module that runs a five-layer build method inside your own Claude Code (npx halfcycle).
Node 20 or newer, and Claude Code. That is the whole prerequisite list. Everything below happens in one sitting.
mkdir tally && cd tally
npx halfcycle
That command signs you in through your browser and creates the project your work gets recorded against. It talks to one address, the same one for everybody, and it ships in the CLI, so there is nothing to configure and no value anyone has to give you first. If it cannot reach us it stops and writes nothing, which is deliberate: a folder set up with no cover behind it is worse than one that is not set up at all.
When it finishes it points you at your project's page on the web. You can also just sign in at app.halfcycle.ai whenever you want.
Click one and you are looking at its console. There is nothing to set up and no second account — it is the same sign-in as the install.
The part worth opening on day one is the crew.
That is the team, live. Twenty-one agents grouped into builders, reviewers, and the ones that are always on. Each shows what it is for and how deep it goes, and each is busy, idle or stood down right now — not a log of what ran an hour ago.
You will not have much on that page twenty minutes in, and that is the point of looking at it early: you can watch it fill up. The first time you run real work, the page stops being a roster and starts being the answer to a question that has no good answer in a terminal. If three agents are running, "what are they all doing" gets you three scrollbacks and a guess.
The other page to know about on day one is the overview, which is where the project's shape lives.
Where each gate stands, which phase is active, and what is happening right now. A phase is a slice of the product that ships and can be shown to someone, and the strip along the top is every gate between you and closing this one.
On a solo project all of this sounds pointless right up until the first time you come back after two weeks away and cannot remember where you were. The console is a faster way to reload a project than your own notes, because it is a record of what happened rather than a record of what you meant to do. On a team it is the only place the work exists for somebody who was not in the session.
Then open the folder in Claude Code.
That is the last instruction in this article, which is worth pausing on, because it is unusual. There is no command to learn, no next step to remember, and no order to get right. Say hello, or say what you want to build, and it takes it from there.
This is the part people are not expecting, so it is worth saying plainly: nothing asks you to fill in a form. It reads the folder first, works out what it can, and then asks you only the things it genuinely cannot answer.
The questions come one at a time, in an order where nothing gets asked before the thing it depends on. Each one arrives with a recommended answer and the reasoning behind it, so the cheap path is to read the recommendation and say yes. And where the answer is a fact about your repo rather than a decision, it has already gone and looked, and it shows you what it found rather than asking you to confirm something it could have checked.
You also cannot get ahead of it. Ask for something three steps away and it either does it, because that is what came next anyway, or it tells you why not and what is missing. There is no path through this where you skip a step by accident, which means there is nothing to hold in your head and no checklist to keep open in another tab.
The one thing it will not do is let you record a decision without a reason. Not a spelling of a reason. An actual one. This is the first place the tool has an opinion, and it is worth understanding why it holds it: in three months, the only difference between a decision you can revisit and a decision you have to re-litigate from scratch is whether anyone wrote down why. Every agent session after this one reads what you decided here. A decision with no rationale attached is a decision the next session will quietly reinterpret.
Answer them honestly rather than quickly. You are the only person in this loop who knows what you are building.
Say it in your own words. Not a spec, not a structured brief. A paragraph.
I want a thing where I can log what I ate and it tells me roughly what I have had this week. Just for me. Web, phone browser mostly.
What comes back is a draft of what you just described, longer and more specific than what you said, and about seventy percent right. That draft is not the product. It is the strawman, and the strawman exists because pushing back on a specific wrong claim is enormously easier for a human than answering an open question against a blank page. Anyone who has been handed a template with an empty "Non-functional requirements" heading knows exactly what that difference feels like.
So it drafts, and then it turns on the draft. Same interrogation shape as the setup: one question at a time, ordered, each with a recommended answer.
Somewhere in there, it asks you something you had not decided.
On a food log, it is usually this one, or a version of it: what happens when you log the same thing twice in one day. That sounds trivial. It is not, and here is the honest shape of why. If two identical entries are one row with a count, your weekly total is a sum over counts and your history is lossy. If they are two rows, your total is a row count and you can show the day back to the user exactly as it happened. Both are fine. But one of them is a schema, and you are about to build on it, and nobody was going to ask.
That is the intervention. It is not a bug caught. It is a decision surfaced before it became a default, which is the only time a decision is cheap.
The tell that it landed is that you stop typing for a second.
Files, in your own folder, in plain markdown. The context your agent sessions read on every future session, the decisions you made and the reasons you gave, and the beginning of a description of your product that is more specific than the one in your head.
Nothing of ours is left in there. The process itself — the steps, the templates, the questions — arrives in the session that asks for it, sized for the step you are on, and is not at rest in your repository. What stays is what you wrote.
You have not built anything yet. You do not need to know what happens next, either. It will say.
Getting started
npx halfcycle
Run that in the folder you want to work in, then open it in Claude Code and say what you are building. Needs Node 20 or newer. There is nothing to learn first and no next step to remember — it tells you what is next when it is next.