# For Agents: qURL Recipes, JSON and CLI Errors

> What a coding agent needs to share a private local app with qURL: task recipes, the JSON to parse, and every CLI error with its fix.

Source: https://layerv.ai/for-agents/

---

For agents

# qURL for coding agents

With qURL™, an agent shares a local app privately: it stays off the public internet, and only the people and machines you approve get in. Read the skill first. Then pick your task below: each page answers one question, with commands you can run and the output to expect.

## Read first

[The qURL skill How to publish an app privately, let people in, and open a CRID. Claude Code reads it from \~/.claude/skills/qurl/; other agents from \~/.agents/skills/qurl/.](https://layerv.ai/skills/qurl/SKILL.md) [llms.txt What LayerV and qURL are, in short form, with links to every guide.](https://layerv.ai/llms.txt)

## Start from your task

- [Publish a private preview from a container, CI job or headless shell](https://layerv.ai/for-agents/ngrok-alternative-for-headless-agents/)
- [Give another agent or machine access, with no email](https://layerv.ai/for-agents/private-localhost-access-for-ai-agents/)
- [Parse the CLI’s JSON in a script](https://layerv.ai/for-agents/qurl-cli-json-for-automation/)
- [Recover after a publish failed](https://layerv.ai/for-agents/recover-failed-publish/)
- [Decide whether you need external supervision or a login](https://layerv.ai/for-agents/headless-native-vs-external-supervision/)
- [Prove the right recipients get in](https://layerv.ai/for-agents/verify-private-preview-access/)
- [Look up an error the CLI printed](https://layerv.ai/for-agents/qurl-cli-errors/)

## Workflows

[Private localhost access for AI agents How can one agent give another agent private access to a local app without an email sign-in?](https://layerv.ai/for-agents/private-localhost-access-for-ai-agents/) [An ngrok alternative for headless AI agents How can a headless coding agent share a private local app without configuring an ngrok authtoken?](https://layerv.ai/for-agents/ngrok-alternative-for-headless-agents/) [Verify private access for browser agents How can an agent prove that the intended recipients can use a private preview and an unrelated device cannot?](https://layerv.ai/for-agents/verify-private-preview-access/)

## Automation

[qURL CLI JSON reference for automation Which qURL JSON fields should an agent parse to publish, inspect, share, and delete a resource?](https://layerv.ai/for-agents/qurl-cli-json-for-automation/) [Headless qURL: native or external supervision? Does running qURL in Docker or CI require external supervision or anonymous login?](https://layerv.ai/for-agents/headless-native-vs-external-supervision/)

## Troubleshooting

[Get unstuck: every qURL CLI message and its fix What does this qURL CLI error mean, and what should I do?](https://layerv.ai/for-agents/qurl-cli-errors/) [Recover a failed qURL publish safely What should an agent do when qurl publish fails after creating a remote resource?](https://layerv.ai/for-agents/recover-failed-publish/) [Fix socket chmod invalid argument in Docker Desktop Why does chmod on a Unix socket fail with “invalid argument” in Docker Desktop on a Mac?](https://layerv.ai/for-agents/fix-docker-desktop-socket-chmod-invalid-argument/)

## For the person using the agent

[Share from Claude Code How do I get Claude Code to share the app I’m building?](https://layerv.ai/guides/share-localhost-from-claude-code/) [Share from Cursor How do I get Cursor’s agent to share the app I’m building?](https://layerv.ai/guides/share-localhost-from-cursor/) [Share from Codex How do I get Codex to share the app I’m building?](https://layerv.ai/guides/share-localhost-from-codex/) [Share from Windsurf How do I get Windsurf’s Cascade agent to share the app I’m building?](https://layerv.ai/guides/share-localhost-from-windsurf/) [Share from VS Code (Copilot) How do I get GitHub Copilot in VS Code to share the app I’m building?](https://layerv.ai/guides/share-localhost-from-vs-code-copilot/) [Share from Gemini CLI How do I get Gemini CLI to share the app I’m building?](https://layerv.ai/guides/share-localhost-from-gemini-cli/)



---

*This markdown version is auto-generated from [https://layerv.ai/for-agents/](https://layerv.ai/for-agents/) for AI agents. Curated agent resources: [llms.txt](https://layerv.ai/llms.txt). For the full interactive experience, visit the HTML version.*

