Add a project from an agent
With the nearhost skill installed, ask your coding agent to serve the project it is working in, and Nearhost opens the add form for you to review.
In the project’s directory, run /nearhost add in Claude Code, or $nearhost add in Codex. Asking in your own words, such as “serve this with Nearhost”, works too.
- The agent proposes the project’s directory to Nearhost, with the dev server’s port when the project’s files say it plainly.
- Nearhost notifies the terminal it runs in:
Agent on mini wants to add /home/dev/code/myapp. Most terminals show it only when Nearhost is not the window or tab in front. - The add form opens over the view with the server and path filled in, and the line
Proposed by an agent on mini. Nearhost reads the project as it does for any add, and you choose the routes and the name as usual. - Save it, and the agent reports
https://myapp.test. Pressescon the path, and the agent is told you declined. - The agent waits up to 30 seconds for the project to start, then runs the doctor on it and offers to work through any errors or warnings it finds. See Fix a project.
If a form is already open, the proposal waits, and Home shows 1 request waiting · p to review. It opens when the form closes, or when you press p. An agent waits 10 minutes for an answer.
/nearhost status reports the project holding the current directory: its address, every address it serves in urls, its state and any error. A project with several web routes or hosts has one URL for each, so you can see where each service lives. /nearhost status --all reports every project on the machine the agent runs on.
Proposals need the full-screen interface. Under nearhost up, an agent can read the status but is told to open nearhost to propose.