Make it yours

Help: something is not working

The chat says a model "needs credentials"

The model is not connected. Go to Model settings, open that model and sign in or paste a key. See Connect your first model.

My project is not running

Check these, in order:

  1. You have a plan, or are in your two free weeks. See Your plan and the two free weeks.
  2. Local Mode is on (Projects, top of the screen).
  3. Atlas Studio is open, or running in the background. See Keep it running.
  4. You are signed in (your name shows at the bottom of the menu).
  5. The project is not Paused.
  6. The project has all its Keys filled in.

To test it, open its Dashboard and press Run now.

It says "Hello there" instead of my name

Atlas could not load your details, usually because the computer is offline. Check your internet. If the app shows the Sign in to Atlas screen instead, press Sign in or sign up. See Sign in and sign out.

Where are my files?

Projects → click the project → Files. On your disk they are in the AtlasStudio folder in your home folder.

Where do I put a password or API key for a project?

Projects → the project → Keys. Never paste keys into a chat.

Can it use my screen?

Only if you turn it on. See Let Atlas use your computer.

Does it work when the app is closed?

Only if you chose Keep running when you closed it. If you chose Stop and quit, nothing runs until it opens again.

Do I have to open Atlas Studio to use Atlas from Claude Code or Codex?

No. Ask your agent to run atlas doctor --fix once; it sets everything up itself. When something it does needs Atlas Studio (your memory, a connector, past chats, a screenshot), Atlas Studio starts by itself in the background, with no window, and the agent carries on.

The guide your agent reads lives here, online, so it is always the newest one. atlas doctor --fix and atlas environment pull fetch it into your Atlas folder, and Atlas Studio does the same each time it opens. To set the folder up by hand instead, download it and unzip it in your home folder:

Download the Atlas folder

Some old folders disappeared after an update

That is on purpose. Atlas clears away folders older versions made that nothing uses any more, like the old local workflows and strategies. Your projects, agents, memories and chats are never touched. See Install and update.

I want the newest version

Profile → Check for updates. See Install and update.

I deleted a chat by mistake

Deleting a chat cannot be undone. Deleted memories, though, can be brought back from Memory → Forgotten.

Need help? Email accesspoint@finmanagerai.com.