EGGENT docs
Mac app

Working on your own subscription

In the Eggent app for Mac a project can run on Claude Code or Codex, already installed on your computer, using your own subscription instead of an Eggent model. Experimental.

If Claude Code or Codex is installed on your computer, the Eggent app for Mac lists it in Settings → Models, under On this computer. A project, or your chats outside projects, can run on it using your own subscription instead of an Eggent model. Nothing is taken from your Eggent balance, and Eggent never sees your sign-in: it starts the program the way you would and reads only what the program says about itself.

What it is

A model is something Eggent sends a request to. A program is different: it has its own tools and does the project's work itself, in the project's folder. Eggent hands it your message, shows what it does as it goes, and keeps the chat, so the stop button, the chat history and the files panel work as in any chat.

It suits work with files and code. It is not the same agent: Eggent's own tools, skills and memory are not in play, see what changes in a chat.

Turn it on

  1. Open Settings → Models. A program found on the computer is listed under On this computer with its version. (Nothing is shown if none is found.)
  2. Installed but not signed in? Press Sign in. The program's own sign-in opens in your browser, and the screen notices when you are done.
  3. Press Use for this project (or Use here, for chats outside projects). The first time, a sheet asks what this means (below) and asks the program for one word to find out that it answers, before anything is moved onto it.
  4. After that it is just a switch. You can also pick the program in the model list under the message box.

Use Eggent's model instead puts the project back on a model. Nothing is lost: the chats stay, and a message that failed on the program can be sent again on a model from the button under the answer.

What the sheet tells you

  • The program works in the project's folder with its own tools, not with Eggent's.
  • It uses the limits of your subscription. What you write and the files it reads go to the company behind it.
  • Schedules, question cards, Eggent skills and Telegram do not work in this mode, and Eggent learns nothing from these chats.
  • Access is yours to set: see below.

Access

  • Changes only in this project's folder (the default). The program changes files only inside the folder. Claude Code cannot run commands at this level; Codex runs them in a sandbox with no network. What the program reads is sent to the company behind it.
  • As in a terminal (the whole computer). The program can read and change anything on your computer that you can, and runs commands without asking first. Choose it only when you mean it.

What changes in a chat

A chat that runs on a program is marked by a line under the message box, which also drops the token counts, since they are not Eggent's to count. Messages after the first are sent to the same session of the program, so it remembers the chat; a chat that already had history gets a short recap on the first message. Files you attach to the chat are named to the program and their folder is opened to it.

A few programs can work at a time; one that has to wait says so ("waiting for a free place").

When the program is not ready

If the program is signed out, out of date, or at the limit of your subscription, the answer says so in the program's own words and offers Continue with Eggent's model.

  • Signed out. Settings → Models → Sign in, then send again.
  • Limit reached. The answer says when it opens again, if the program tells; wait for it, or pick another model for the project.
  • An API key was found. The program would bill the key instead of your subscription, so Eggent does not start it. Remove the key from its settings or the environment.
  • Too old. Update the program.

When the cloud hands a chat to your computer

A project that runs on a program can also be run from the cloud, if you let it: see Letting the cloud run chats on your computer. If you chose Ask me for each chat, the app asks about such a chat by itself, names the program and how far it reaches ("It can change files only in the project's folder", or "It can read and change anything on this computer that you can, and runs commands without asking"), and an allowance for it covers only that program at that reach. Allow every chat covers these chats too. If the program on this computer is not ready, the chat says so, and Run it here instead puts it back where you are.