Start here

Quickstart: the app

Public beta

Download, Log In, give an agent a job. At the end an agent will have done real work, and you will have approved the one step that changed something.

The Lobstack app is a free desktop app for Windows, macOS and Linux. Agents work in your files, repositories and connected tools. A step that only reads runs straight through; a step that changes something waits for you. Building against the API instead? Start with Quickstart: the API.

From download to a finished job

  1. Download and install

    lobstack.ai/download offers the newest published installer for your system. The download is free, and the app updates itself after that.

    SystemWhat you getThe first time you open it
    WindowsA setup .exe, signedSmartScreen may still say it protected your PC while the certificate is new. Choose More info: it names the publisher, Brandon Crenshaw. Then Run anyway.
    macOSA .dmg, for Apple Silicon, signed and notarized. There is no Intel build.Drag it to Applications and open it. macOS asks once whether to open an app downloaded from the internet.
    LinuxAn AppImageMark it executable and run it.

    The Windows and Mac builds are code-signed from 0.11.10. SmartScreen also weighs a certificate's reputation, which a new one builds over weeks of installs, so Windows may ask once until then. A copy older than 0.11.10 still updates itself in place.

  2. Sign in

    The app opens on Sign in to start. Press Sign in with Lobstack: your browser opens lobstack.ai, where you sign in or create a free account. Check that the code on the page matches the one in the app, then press Connect. The app picks up the result by itself. There is no key to paste.

    A verified API or app Log In adds $5 of Gateway credit for 30 days, once, with no card. After that, Free stays free on your own key or GitHub Copilot. See Free trial credit and Pricing & plans. Prefer GitHub Copilot or your own OpenAI or Anthropic key? Open Other ways to run your agents on the same screen; neither needs a Lobstack account.

  3. Pick an agent, or make one

    A new workspace starts with three agents, Triage, Research and Ops, on a #general team. Write there without naming anyone and the agent whose job fits answers. Ops asks about everything; the other two ask before they change anything.

    To make your own, press New agent in the sidebar. Choose Describe it yourself or Start from a written-up job, set its name, its job and how much it asks, and press Create. Everything can be changed afterwards.

  4. Give it a first job

    Every agent can search the web, read pages and use a browser without a connector. For work in your files, give it a repository or add a connector, such as GitHub, Linear or a folder.

    Then message the agent as you would a colleague. Home’s Get your first real piece of work done card has a ready one: Try: write a one-page brief opens the agent’s conversation with the task filled in, so you see exactly what it will be asked before you send it.

  5. Approve what changes something

    Searching and reading run without asking. When the agent wants to write a file, run a command, click on a site or post a document, the run stops and an approval card shows exactly what will happen: the command as it will run, a file change as a diff, a document as the page itself.

    ButtonWhat it does
    ApproveRuns this one call, and the run continues.
    Always allowAllows calls of the same shape for the rest of this session. Gone when the session ends.
    DenySkips it. Say why, and the agent works around it rather than failing.

    Waiting cards also collect under Approvals in the sidebar, and one still waits after the app restarts. The rules are on The approval gate.

  6. Find the result

    The reply lands in the agent’s conversation, with what the run cost. A document opens in a pane beside the conversation and is kept in the Library, with every other file your agents have made, ready to export to Word or PDF. Home lists it under Recent documents. When an agent has changed a repository, a Changes chip on the conversation shows the diff.

Where to go next