All lessons · 44
AI-Assisted Coding: The New Tools
Claude Code, Cursor, Windsurf, Codex, Gemini, Replit and opencode. What agentic coding tools do differently from autocomplete, and how to choose one.
From autocomplete to teammate
The first wave of AI coding tools completed your lines: type a function name, get a suggestion, press Tab. Useful, but passive — the model only reacts to what you type.
The current wave is different. Tools like Claude Code, Cursor, Windsurf, Codex, Gemini, Replit and opencode are agentic: you give them a task, and they work on it on their own. The difference is not the model — it is what the tool is allowed to do around the model.
A coding agent is an assistant that can open your project, read the files, change them, run commands, see what happened, and try again — then report back with what it did. You describe the outcome; it does the digging.
Do you need to be a programmer to try one? No. That surprises people, but plenty of these tools are now used by designers, analysts, teachers and founders for ordinary jobs: turning a spreadsheet into a small interactive page, renaming two hundred holiday photos by date, pulling data out of fifty PDFs into one table, building a tiny personal website. You do not need to understand the code the agent writes — you need to be able to describe what you want and check the result. Both are ordinary human skills.
Why you should care
Two hours of tedious computer work — renaming files, copying numbers out of PDFs, rebuilding the same table every month — is now often one sentence of plain language. You do not have to become a programmer to get that. You have to describe the outcome clearly and check what comes back. That is the whole skill, and this article is about where to aim it.
What agentic tools actually do
An agentic coding tool wraps a language model in a loop with permissions to touch your real project:
- Read the repo. It searches files, follows imports, reads your configs and tests to learn the codebase before changing anything.
- Edit files. It applies changes across multiple files, not just the one you have open.
- Run commands. It can execute build steps, linters and test suites — and read their output.
- Iterate. If a test fails, it reads the failure, changes the code and tries again, without asking you each time.
That loop is why these tools feel different from autocomplete: they handle whole tasks, like “add pagination to the users endpoint and update the tests” — not just the next few keystrokes.
Words you will see
You will meet these words in the first ten minutes. None of them is hard:
| Word | What it means here |
|---|---|
| Terminal | A text window where you type commands instead of clicking icons. Some agents live here. |
| Repository (repo) | Your project folder — plus a memory of every change ever made to it. |
| Command | One line of text that makes the computer do something, like “run the tests”. |
| Tests / test suite | Automatic checks that answer “did I break anything?” without a human clicking through the app. |
| Commit | A saved checkpoint of your project. A place you can go back to. |
| Endpoint | One address of an app that takes a question and returns an answer, like /api/projects. |
| Prompt | The instruction you give the AI, written out in words. |
| Diff | The list of changes: lines added, removed and edited. What you read before you say yes. |
The loop, step by step
Six steps, every time. This is the whole difference between a chat box and an agent:
One or two sentences: what you want, and how you will know it worked.
Plain language is enough. Say you are not a programmer and the agent will drop the jargon.
A session, step by step
Here is what working with an agent looks like from the inside:
Notice what the human did: wrote one sentence, answered one question, approved the commit. The agent did the searching, editing and testing.
The landscape
The tools differ mostly in where they live:
| Tool | Where it lives | Pick it if you… |
|---|---|---|
| Claude Code, opencode | Your terminal | live in the shell and want the agent next to git and your tests |
| Cursor, Windsurf | A full editor built around AI | want files, chat and agent mode in one window with buttons |
| Codex, Gemini | Editor, chat or the cloud | want an agent working on a task while you do something else |
| Replit | The browser | want code, database and hosting in one place, with no setup |
Two words from the table that are worth knowing: git is the system that remembers every checkpoint of your project, and CI is a robot that runs your checks automatically every time you save a change.
There is no single winner. They evolve weekly, and most are cheap enough to try that the honest answer is: pick one, use it on a real task this week, and switch if it annoys you.
What they are for
The biggest mistake newcomers make is using agents as fancy autocomplete. The real leverage is delegating whole tasks:
- Well-understood, boring work — CRUD endpoints (the standard create, read, update, delete plumbing for one kind of data), form validation, database migrations, renaming across the codebase, writing missing tests.
- Exploration — “where is the payment logic?”, “why does this test fail?” An agent that reads the repo can answer in a minute.
- Repetitive changes — upgrade a dependency and fix every place that now warns, apply one pattern to twelve files.
- Scaffolding — a first working version of a feature that you then refine yourself.
The rule of thumb: if you could write a clear paragraph describing the task and how to verify it, an agent can probably do it.
Try it: your first task
The fastest way to understand these tools is to hand one a small, harmless job. Pick something you could throw away without caring, and say plainly that you are not a programmer — the agent will switch to plain-language explanations.
Copy this prompt and paste it into Claude Code, Cursor, Codex, ChatGPT or any other agentic tool:
I am not a programmer. Please help me build one small thing and explain every step in plain language.
What I want: a single file called budget.html that I can open in my browser. It should show a table of my monthly expenses with 5 example rows I can edit, and the total at the bottom that updates when I change a number.
Rules for you:
- Ask me at most two clarifying questions, then do the work.
- Work inside one new folder so nothing else on my computer can be touched.
- After each step, tell me in one sentence what you did and what I should look at.
- Do not delete or change any existing files. Nothing that sends my data anywhere.
- When you are done, tell me exactly which file to open and how to open it.Two things to notice while it works: it will probably ask you a question or two before touching anything, and it will show you its plan in words you can read. If either part is missing, you are using a chat box, not an agent.
The agent still needs a driver
These tools are fast, confident and occasionally wrong. They will pass the tests you have and miss the ones you do not. You stay responsible for reviewing changes — look at the actual files, run the thing yourself, and keep a way back (git, or a copy of the folder) before you let an agent loose on anything you care about.
Check yourself
What makes a coding tool an agent rather than autocomplete?
Do you need to be a programmer to try a coding agent?
An agent says "done, tests pass." What is still your job?
Which of these is the best first task for a coding agent?
Your takeaway
Three things to do this week, in order:
- Pick one tool and install it. Ten minutes. Do not spend three days researching — the tools change monthly, and every one of them is good enough to start.
- Hand it the throwaway task above. Something small you could delete without caring. Watch how it asks questions and shows its plan — that behavior is the product, not the code.
- Save one checkpoint before you start. A copy of the folder, or a single commit. This is what makes saying “go ahead and try” free.
The skill that matters is not knowing the tool. It is knowing what to hand over: a task you can describe in one paragraph, with a way to check the result.
Where to go from here
You know what these tools are and what to delegate to them. Later in the roadmap: evaluation and observability — how to measure whether all of this actually works once other people are using it.