Skip to main content

Test Locus on your own files

Request a tester spot

Spots are limited to the first 100 testers. Testers get 3 days of full access (local and managed indexing, and connections to AI apps that support MCP) in exchange for a short survey. We confirm by email. No launch offer is promised for testers.

Which AI apps do you use? (choose at least one)
Your computer (required)

Voluntary. Yonathan Levy, who runs Locus, uses your email address, AI apps and operating system only to choose testers and to email you about a spot, a short survey and the launch discount. Kept 12 months, then deleted. Full notice

We're asking people who use an AI assistant every day to try Locus on a folder of their own files, then tell us honestly what worked and what didn't. The test takes about 20 minutes, plus about 3 minutes for the survey after it.

The test is by invitation for now: only the email address we invited can create an account. Not invited? Request a spot with the form above, or Join the waitlist and we'll email you when Locus opens.

What the test is

You install Locus, index a folder of your own files, connect it to your AI assistant, and ask the assistant three real questions whose answers are spread across several of those files. Each answer should cite the files it used. Then you answer a short survey in your dashboard. Please work through it on your own first: whether you get there without help is part of what we measure.

What you need

  • A computer running macOS or Linux (Windows is not yet verified), with Python 3.11 or newer.
  • Being comfortable pasting a few commands into a terminal.
  • An AI assistant that can use MCP tools. Locus works with Claude Code, GitHub Copilot CLI, Codex, Claude.ai (web app) and ChatGPT (general chat, not Codex), with cited answers. Claude.ai and ChatGPT connect through Locus's hosted relay. The Connect page has steps for more, each labelled with how far along it is.
  • A folder of real files: start with a few hundred. The compatibility page lists the file types Locus reads.

What you get

A free tester account. Managed embeddings and remote connection work for 3 days from the day you create it; the survey stays open after that. Usage limits still apply: the trial's token budget, a daily limit, and at busy times a pause on trial indexing until the next UTC day. Testers who complete the day-3 survey are emailed when Locus opens; no launch offer is promised until its terms are published.

Paid plans are not open yet. One survey question asks which plan you would pay for. It only records your interest: nothing is held or reserved, no card is taken, and no checkout link is promised. The list prices are on Pricing.

Your answers decide what we fix first.

What leaves your computer

Your raw files are never uploaded to Locus. On managed plans, chunk text and your search queries pass through Locus's relay to Voyage AI to be embedded. We don't store them; we keep only usage counts. When your AI assistant searches, the matching excerpts go to that assistant, as they would if you pasted them in.

The steps below use managed mode, which your trial includes. If you would rather compute embeddings on your own computer, the local mode on Connect needs no account. The full table, mode by mode, is on Privacy.

The guided test

About 20 minutes from the first command to the first cited answer, if nothing goes wrong.

  1. Step 1: Create your free account

    Sign in with Google or GitHub. A new account starts with a free trial.

  2. Step 2: Create an API key

    In your dashboard, create an API key and copy it. It's shown once.

    Anyone who holds your Locus API key can search and read your indexed files through the relay while your computer is serving, take over as your relay computer, spend your managed-embedding budget, and act as your account for up to ten minutes with each relay token they get from it. Keep it secret. If it leaks, revoke it from the dashboard, then check your key list again after ten minutes and revoke any key you did not create.

  3. Step 3: Install Locus

    You need a terminal on macOS or Linux (Windows is not yet verified). We recommend uv, which installs its own Python; pipx works too if you have Python 3.11 or newer. Install the locusfiles package; the command it adds is locus:

    curl -LsSf https://astral.sh/uv/install.sh | sh   # installs uv, then open a new terminal; skip if uv --version works
    uv tool install --python 3.12 locusfiles         # or: pipx install locusfiles
    uv tool update-shell                              # then open a new terminal
  4. Step 4: Check it, then index a folder

    Paste these one at a time, with your key in place of <your key> and a real folder of yours (start with a few hundred files):

    export LOCUS_EMBEDDER=managed
    export LOCUS_API_KEY=<your key>
    locus doctor
    locus index ~/Documents/<a folder> --prune
    locus query "a question about that folder" -k 5

    Every locus doctor check should pass; a failing line names the fix. The last command should print matching excerpts with their file paths. The free local mode is optimized for English; managed mode uses a multilingual model. We have not yet measured search quality in other languages.

  5. Step 5: Connect your AI assistant

    Follow your assistant's steps on Connect. Then add this to the locus entry of its config, so the assistant's Locus uses your key too:

    "env": {
      "LOCUS_EMBEDDER": "managed",
      "LOCUS_API_KEY": "<your key>"
    }
  6. Step 6: Ask 3 questions

    Ask your assistant three real questions whose answers are spread across several of your files. Each answer should cite the file paths it used.

  7. Step 7: Answer the survey

    Up to nine questions, about 3 minutes, in your dashboard.

Stuck? Please try on your own first: that's part of what we measure. Then email yonilev2003@gmail.com with the step and the error, or see Support.

The survey

Up to nine questions, about 3 minutes, once per account, in your dashboard:

  1. How far you got: a cited answer from your own files, with or without help, or where you stopped.
  2. About how long it took to get the first cited answer.
  3. Which AI assistant you used it with.
  4. Whether the answers cited the right file.
  5. How you would feel if you could no longer use Locus.
  6. Which plan you would pay for when paid plans open, if any, and monthly or yearly.
  7. What's missing for you (optional).
  8. How likely you are to recommend Locus, from 0 to 10.
  9. Anything else, and what would make Locus a must-have for you (optional).

Questions 2 and 4 are asked only if you got a cited answer.

Your privacy

Taking part means creating a Locus account; the sign-in page says what that stores. The survey: Optional. Stored with your account and used only to improve Locus and count the tester results. You can ask us to delete your answers at any time. Your answers are stored with your account in our database (hosted by Supabase). We don't sell them or use them for advertising. To see, correct or delete them, email yonilev2003@gmail.com. Who we are and all your rights: Privacy.

Stuck, or have a question before you start? See Support.