NomiCode local agent

Runs in your project directory. Polls the NomiCode backend for pending instructions and writes each to .agent/tasks/<id>.md for you (or Cursor) to act on. Does not edit code or run git by itself.

Setup

1. In the NomiCode web app, open a project and copy the agent token (under "Connect local agent").

2. In your project directory (the codebase you want to receive instructions for):

   export NOMICODE_AGENT_TOKEN="<paste-token-here>"

   Optionally set the API base URL if not using the same Supabase as the app:

   export NOMICODE_API_URL="https://YOUR_PROJECT_REF.supabase.co"

Run

From this repo (Nomicode root):

cd agent
NOMICODE_AGENT_TOKEN=<your-token> node index.js poll

Or with the Supabase URL (if not already in env):

NOMICODE_AGENT_TOKEN=<token> VITE_SUPABASE_URL=https://xxx.supabase.co node index.js poll

The agent polls every 15 seconds. For each pending instruction it:

1. Writes .agent/tasks/<instruction_id>.md with Goal, Context, Constraints, Suggested files, Implementation.
2. Reports status sent to the backend so the UI shows "Sent to agent".

You (or your IDE) open the file and make the changes. To report "Applied" or "Failed" from the agent later, you can extend this script or use the API (PATCH /functions/v1/update-instruction-status with instruction_id, status, optional status_message).

Placeholder: git commit

The spec says "commits changes to git only after user confirmation". This scaffold does not run git. A future version could, for example, prompt after you edit the task file or add a separate nomicode-agent commit <instruction_id> command that runs git add .agent/tasks/<id>.md && git commit -m "..." after you confirm.