FAQ

What is Longshot?

Longshot is a mobile-first web app for directing Claude Code agents. You describe work from your phone, the agent builds it, and you review diffs and approve changes — all from a mobile browser.

How does it work technically?

The Longshot CLI runs on your development machine and spawns Claude Code as a subprocess. By default it connects to the Longshot cloud proxy so you can access your agent from your phone anywhere — no local web server, no port forwarding. Use --local to run a local web server instead.

Is my code secure?

Yes. Your code never leaves your machine. The cloud proxy only forwards requests between your browser and your CLI — it doesn't store, cache, or inspect your code. All source files stay on your local filesystem.

The tunnel connection uses WebSocket Secure (WSS) for encryption in transit. Auth tokens are generated per-daemon and can be revoked at any time from the dashboard.

What data does Longshot store?

On your machine: Task specs, conversation history, run logs, and diffs — all stored in .longshot/ inside your project directory. These are committed to git as part of your project history.

On our servers (if using the tunnel): Your email, hashed password, daemon names, and basic usage metrics (request counts per endpoint). We do not store your code, conversations, or task content.

Do I need a Claude API key?

No. Longshot uses the Claude Code CLI, which handles authentication with Anthropic. You need Claude Code installed and authenticated — Longshot spawns it as a subprocess and doesn't manage API keys directly.

Which languages and frameworks does it support?

Any. Longshot is language-agnostic — it works with any codebase that Claude Code can read and modify. The agent gets full access to your project files and can run commands, tests, and build tools.

Can I use it with multiple projects?

Yes. Run longshot in each project directory. Each project gets its own .longshot/ directory with a separate task list, spec, and history. Connect multiple machines via the dashboard.

What does it cost?

Longshot is free with one agent connection and all features included. You only pay for your Claude Code usage through Anthropic.

Pro ($5/mo) adds a managed cloud proxy for mobile access from anywhere, push notifications, and up to 3 agent connections. See pricing for details.

Can I use it without the cloud proxy?

Yes. Run longshot --local to start a local web server at http://localhost:3333. You get the full mobile UI — the proxy is only needed for access from outside your local network.

What happens to my git history?

Longshot commits approved changes directly to your current branch (or a feature branch if you've created one). Each approval is a clean git commit with a clear message. Rejected changes are discarded entirely — no trace in your git history.

Task specs, conversations, and run logs are also committed to git in the .longshot/ directory, giving you a full audit trail.

Is Longshot open source?

No. Longshot is proprietary software. All rights reserved.

How do I get help?

Email hello@longshot.dev for support.