What I Learned Using Free AI Coding Agents on a Real Portfolio (OpenCode and Kilo)

I'm a student, and I built and kept improving my portfolio with free AI coding agents running in the VS Code terminal. I used OpenCode and later Kilo, both on free models.

They saved me a lot of time, but they also got stuck, lied by accident, and once looked busy for a whole hour without doing anything. Here is what I learned, so you can skip my mistakes.

My mobile menu showed a dark overlay and an "X" button, but the menu links never appeared. My first prompt was "fix it", and the fix didn't work.

What worked was splitting the job into two steps:

First, read only. Do not change anything. Find where the mobile menu is rendered and tell me exactly why the panel is invisible, with the file and line number. Then fix it. Enter fullscreen mode Exit fullscreen mode When the agent has to name the real cause, it stops guessing. In my case the real cause was a previous commit that had removed the menu panel completely.

My long prompts that asked for five changes at once often ended with "not done in this session". Short prompts with one job each worked much better.

Change ONLY <one function or one section> in <one file>. Do not touch anything else. Use only text that already exists. Do not invent new content. Do not commit or push. Run the typecheck at the end and tell me which lines you changed. Enter fullscreen mode Exit fullscreen mode 3. Always tell the agent not to commit or push Agents are happy to "help" by committing and pushing. I wanted to review every change first. So every prompt says: do not commit or push. I check git status and git diff myself, and then I commit.

Several times the agent said "typecheck passed", and I still had problems after deploying. The typecheck only checks types. A real build can still fail, and a failed build on Vercel means your site stays on the old version.

Ask for the build too, and when it uses environment variables, give them:

$ env: PORT = "5180"; $ env: BASE_PATH = "/"; pnpm --filter @ workspace/ritika-portfolio build Enter fullscreen mode Exit fullscreen mode Before you ask "why is my change not live?", check the deployment status in the Vercel dashboard.

I once asked an agent to verify a fix with a headless browser. It spent an hour fighting spawn pnpm ENOENT on Windows and trying one workaround after another. Now my prompts say: "Do not test in a browser or start a dev server. Only run typecheck and build." I look at the page myself.

Agents often write bash commands. On Windows PowerShell I kept seeing errors like:

If your agent keeps hitting these, add a line like "I use Windows PowerShell, so use PowerShell syntax" to your prompt.

A few times the agent answered "Already implemented, no changes needed". Sometimes that was true. Sometimes I wanted proof. I started asking it to name the file and line number of the change, and then I searched for that text in VS Code with Ctrl + F. If the agent can't point to a line, don't trust the claim.

Free agents can hit a daily limit, or ask you to sign in. Mine said "You need to sign in to use this model" in the middle of a task. Signing up with an email was free and took a couple of minutes. Be ready to switch tools, and never run two agents on the same folder at the same time, because they will edit the same files and cause conflicts.

Don't paste API keys, tokens or your.env file into a prompt or a chat. Keep them in environment variables and in your host's secret settings. Before pushing, search the diff for words like key, secret, token and password.

AI agents are great helpers, but they are not a replacement for checking your own work. The more specific and small my prompts were, the better the results.

You can see the portfolio I built here: ritika-rajput-portfolio.vercel.app. I also share videos on RitikaMoments.

What is the biggest problem you ran into while coding with an AI agent?