Ergod
Personal workspace Home
An AI agent. A world to make together.
Live Free · No install · No setup
What should we make?
Type it, sign in once, and it runs in a workspace of your own — a page, a game, a plan, an answer with sources.
Or message it on Telegram — no account needed.
Checking workspace…Only you
A little space for your next idea.
What are we making?
Describe what you want built. Your personal chat and shared rooms keep separate histories and workspaces.
Your personal conversations.
- Loading…
A shared workspace and conversation for people you invite directly. Web-room invites do not grant Discord access.
A room is opened here and joined with an invite code, by anyone on any platform. It belongs to you, not to a server, and it is the only one of the two you can start from this page.
A Discord room is available to everyone who can use Ergod in that Discord channel. Each person chooses the shared room or their own agent. It has to be started in the channel itself.
Both share one workspace and one history, and in both each person's turns come out of their own usage.
- Loading…
Room
Settings
Your account, how Ergod works for you, and who can see your work.
Your account
Account
Who you are here, and which sign-ins open this account.
Profile
Sign-in methods
Every method below opens this same account — the same workspace, memory, usage and plan. It does not matter which one you use, or which device you are on.
Ends every browser sign-in for this account — this one and any other browser you left signed in — and sends you back to sign in here. It does not undo anything already done in those sessions, it does not disconnect your connected desktops (revoke those on their own page), and it does not remove anyone else from a shared room.
Your account
Usage & billing
What is left this period, when more returns, and the plan behind it.
Review your purchase
Usage
Usage measures the work a turn takes, not how many times you asked. A one-line question and a build that reads forty files are not the same slice of this meter, which is why there is no message count on this card.
Longer conversations, bigger models and generated images all cost more. The bar beside each model on Settings shows how much of this a model spends per turn.
Plan and billing
Pro+ expands Pro's usage and storage capacity, with the same model choices and collaboration features.
In a shared room, each participant uses their own allowance.
Your Ergod
Settings
How Ergod works for you: models, preferences, connections, skills, schedules and memory.
On this page
Account & access
Appearance
Choose the colours you see throughout your dashboard. This is your viewing preference; it does not change a room’s identity or the Discord working-card colour.
Readable text, clear focus, and familiar controls.
Primary actionLoading your appearance…
Models & providers
The defaults Ergod uses when it writes, reasons and creates images — and your own provider key, if you use one.
Which model answers you. Applies everywhere you use Ergod — here and in Discord. Listed cheapest first; the bar shows how much of your usage each one spends per turn. Picking one here saves it; change it any time from the pill above the conversation.
Which model draws when you ask for an image. Images and text share the same usage, so a pricier one here spends the same allowance your turns do.
Your usage stretches about five times further when turns run through your own Claude, GPT, Gemini, Grok or OpenRouter account.
- Add a key for a provider (the ? above says where one comes from).
- Turn it on. You pay that provider directly; it works on every plan, including Free.
A key comes from the provider's own developer console, not from Ergod: Claude, GPT, Gemini, Grok or OpenRouter. That provider bills you for what you spend through it.
Once saved, a key is never shown back to this page — not even one you just pasted. Replace it by saving another, or turn it off to put your turns back on your plan's usage; both leave the key where it is until you remove it.
Preferences
Connected services
Choose the services Ergod may use while it works. These are separate from your sign-in methods.
Ergod can clone, commit and push to your repositories when you ask it to.
- Make a token at github.com/settings/tokens with the
reposcope (the ? above has the details). - Link it here, then ask — “clone my-org/site and fix the footer”. Nothing is pushed without a request.
Signing in with GitHub does not grant repository access. The token is never shown back to you.
Make one at
github.com/settings/tokens. A classic token
needs the repo scope; a fine-grained one needs
Contents: read and write on the repositories you
want Ergod to touch.
Give it an expiry you are happy with — when it lapses, cloning and pushing start failing and nothing here changes on its own. Paste a new one into the same field to replace it.
Shell commands get the tokens they need — npm, PyPI, Docker Hub — without you pasting a secret into chat.
- Link a token under the provider’s name.
- When a command needs it, Ergod requests it and you approve; the token arrives as an environment variable for that command.
Names and labels only; values are never shown here.
Tools from services you choose — your issue tracker, your docs, an internal API — that Ergod can use in every session.
- Add a hosted server with its URL, and a token if it needs one.
- Ask for something the service does; the server’s tools are there. Disable one here without removing it.
Connected servers give Ergod tools from services you
choose. Add hosted servers here; install local servers with
/mcp add in Discord, which this
account cannot reach yet; link Discord under Sign-in methods on
Account.
MCP is an open standard for giving an assistant tools it did not ship with — your issue tracker, your docs, an internal API. Connect a server here and its tools become things Ergod can use on your behalf, in every session.
The protocol and a directory of existing servers are at modelcontextprotocol.io.
Run work in your Ergod workspace from Claude Code, Cursor, VS Code or any MCP client. The task runs here, on your files, and the results come back to the tool that asked.
- Create a key below and copy it — it is shown once.
- Paste the one-line config for your client. Ergod's tools
(
run_task,get_task_status,list_artifacts,get_artifact) appear in that tool.
A key below lets an MCP client sign in as you, run a task in your own container, and fetch the files it produced. The work happens here, not on your machine, and the files stay between sessions.
Your spending cap and usage apply exactly as they do in chat — a task started this way is an ordinary turn.
Copy it now. This is the only time it is shown. We store only a fingerprint, so we cannot show it to you again — if you lose it, revoke it and make another.
Endpoint , bearer
token. The config above contains your secret key — keep it
out of shared files.
Connect the OpenAI Agents API
Add this object to agent.tools when
creating a session. It includes your secret key; keep it out
of shared files and reusable agent definitions.
This lets your agent run work and retrieve files.
To send results to Discord, also allow deliver_result.
Your Ergod usage and spending cap apply.
OpenAI connection guide
Skills
Step-by-step playbooks Ergod wrote down, loaded on their own whenever they apply.
- Ask in plain words — “turn what we just did into a skill”.
- Disable or remove one here when it stops being true.
Scheduled tasks
Give Ergod something to do regularly.
- Create a task here or ask in chat, with instructions and a schedule.
- Review its instructions, change the timing, or pause it whenever you need.
Memory
Preferences, project notes and useful references from your personal sessions can appear here. Edit or delete anything you do not want kept. Shared rooms and channels keep their own memory separate from yours.
Work with people
Sharing & access
Who can see or work on what: public links, room invites, and the people in your workspace.
Collaborators
People you invite to your workspaceThey read and write the same files as you, in the same sandbox. Your memory and your other sessions stay yours. Free accounts can collaborate — only you need a paid plan.
Send this to the person you want to share with. It works once, and expires in a day.
Add by Discord user ID instead
Right-click someone in Discord and choose Copy User ID. You may need Developer Mode on in Discord's Advanced settings. Both of you need Discord for this one — an invite does not.
Shared channel sessions
People who can see the channelMembers can choose the channel's shared agent, history,
and workspace, or their own. Replies and files posted in the channel
stay visible either way. Start a new room with
/share-session in the channel itself.
Your links
Anyone with the linkAnyone with a link can open it without signing in. Revoking breaks the link immediately. Only links listed in the public gallery are discoverable.
- Loading…
Play links and invites
Room members onlyOpen to everyone in the room, and nobody else. To share one further, open it and choose Share from the player.
Each code admits one person and expires in a day. Revoking a code makes it useless before anyone spends it.
Sharing creations
Public by link · gallery after reviewSharing a reply captures that reply and its listed sources. Sharing a personal workspace file captures that file and the assets it uses. Both create an unlisted public link anyone can open without signing in. The link is not private or listed in a gallery, and you can revoke it from Shared links.
Choose Submit to gallery beside one of your public links. It becomes discoverable only after developer review. Review applies to that exact snapshot and does not guarantee safety or accuracy. Shared channel links keep their existing channel-access rules.
Workspace
Applies to you onlySwitching moves your whole session — files, memory and history follow the workspace, not you.
Discord
Discord servers
Add Ergod to a Discord server, then choose how it behaves there and which channels share a room.
Checking which Discord servers you manage…
Add Ergod to a Discord server
Run Ergod in a server you already use. You need Manage Server there. Once it is in, this page is where you configure how it behaves.
Add Ergod to a serverNot the admin? Add Ergod to your account — its commands work in every server you're in — or join the community server and use it there.
Discord server
These settings belong to the server, not to you. You need Manage Channels to edit them. The policies below affect every member; the first-choice recommendation guides members who have not saved their own choice. Your own defaults — model, memory, workspace and channel routing — are on Settings.
Add Ergod to your own serverServer configuration
Shared channel sessions
A shared channel session gives members a shared agent, history, and workspace. Each person can choose that room or their own agent; replies and files posted in the channel remain visible to the channel either way.
The sponsor provides the workspace and its storage. Everyone else still spends their own usage, so being in one costs a member nothing and needs no plan.
Open one with /share-session in the
channel itself. Detailed room controls remain in Discord because
this page cannot see which channels you are in.
Support Ergod
A vote on top.gg adds credits to your account that never expire — you can vote twice a day. Vote each time the window clears to build a streak, and help more people find Ergod.
Vote on top.ggShared work
Rooms
Places to work with other people: web rooms, Discord channels and game tables. Each one below says who can join and how to start one.
Web rooms
An invited browser workspace with its own conversation and files. Hosting one takes Pro or Pro+; joining with a single-use invite code is free.
Loading rooms…
Discord rooms
Ergod in a Discord server channel, opened there with /share-session. Anyone who can see the channel can take part.
Loading Discord rooms…
Game tables
Tables from Play. Everyone in a table’s room can take a seat or watch, and watching a web table joins its room as a member.
Loading game tables…
Choose a room
Its audience, recent activity, and actions will appear here.
Play
Play
Games you can play with Ergod, or with friends in a room.
Pick a game. Ergod takes the other seat. Everyone in your room can watch or join.
Public tables other people opened. Join when a seat is free. Watch joins the room without a seat.
Rooms you are in. Play together opens a table there; everyone in the room can join or watch.
Also on
Discord — the same tables as an Activity in any server Ergod is in.
On Telegram, send /play to open a table in the chat.
Your library
The things you made and kept, and where they live.
Loading your library…
Nothing here yet
Pages, files and links you make with Ergod collect here.
Service view
Operator console
Service health, growth, money, security and account lookup. The server checks operator access on every request.
Analytics
Showing the last 7 days
Loading…
Show
At a glance
People, and where they came in. The install split starts on the day it was first recorded; the panel says which day.
Where people use it
First provisioned
How usage is spread
All time · does not follow the window
Accounts
Monthly subscription amounts, recorded payments, price estimates, and credit units are separate measures. Spend and payments use separate chart axes.
Revenue accounts only
Changes revenue totals and revenue charts only. Usage, growth, cohorts, and provider test transactions are unaffected.
Who hit the cost cap
The wall · meter seen, then what
Turns and spend
Events
Purchase interest
By trigger · what put the offer in front of them
Money evidence · each figure keeps its own unit and time basis
Revenue evidence
Observed HTTP requests, not compromise verdicts. Records recognized probe categories and HTTP 401/403 outcomes, independent of the internal-account filter. Ordinary successful page visits are not captured.
Request observations
Probe bursts
Repeated observations
Recent observations
Only route templates and probe categories are retained; query strings, credentials, bodies and user-agent claims are excluded. Client and socket-peer digests are separate. Proxy attribution requires a configured trusted socket peer and valid IP headers; the ingress must sanitize those headers. A digest is a network observation, not a person, bot provider or Discord account. Digests change when the session key rotates.
Retains at most 30 days and 20,000 events. Groups and recent rows each show up to 100 entries. Capture can lag a few seconds; process counters reset at restart. Change capture in Product → system switches.
Classes and counts, never a message: no prompt, path or provider response can reach this page.
Where turns fail
Before the agent starts
| Stage | Outcome | Samples | Median | 95th percentile | Longest |
|---|
Containers
Activity health
Long turns & stalls
Per user
Tool patterns
Most common sequences
Sequences that ended badly
Per tool
Runtime incidents
Tool health
All time · does not follow the window
Live · right now · does not follow the window
Service
Whether people start, what they do, and whether they come back — the questions the roadmap hangs on.
Signed in, then what
Web sign-ins · where they came from
Arrived, used it, paid
What people bring it
Rows that are not turns
Who comes back
By what a person mostly did. "Came back" means active on two or more separate days — one long afternoon is not retention.
Activity frequency in this window
By total turns during the selected window. Returning on another day adds turns, so the 1-turn row cannot contain a return.
Did the hello menu earn its turn
Shared rooms
Activity
Command use
Creations
Cohorts · starting in the window, followed forward past it
Discord scope choice
Requests held for a personal or shared choice. Stages follow the same requests, including outcomes after the selected window.
First-session depth cohort
By how far somebody got in their first session, then whether they came back at all afterwards.
Weekly cohorts
Live · right now · does not follow the window
Models
One switch. Every tier falls back to this, and every user who has not chosen their own model runs on it. Free text so the registry never blocks a new id; the server still validates the shape.
First-turns routing. Puts a free user's first few lifetime turns on the model below, then falls back to the tier default. Off stores an explicit off — it beats the config file.
System switches
Process-wide, and they apply to everyone. Each one says whether it takes effect now or at the next restart, and what it falls back to if you clear it.
Macro analytics
Aggregate counts for the selected window and the applied revenue account filter. No user IDs, message text, or file paths are exported; only the number of custom revenue exclusions is included.
Live · right now · does not follow the window
Support lookup
Their tier, cap state and recent turns. Not their messages, their files, their sessions or their keys.
Account
Recent turns
Recent events
What this cannot answer
Recording gaps, not empty results. Nothing above can speak to these, so a zero anywhere on this page never means one of them.
Live · right now · does not follow the window
Gallery review
Approve only the exact submitted snapshot. This review does not cover later comments and does not guarantee safety or accuracy.
Listed now
That didn't go through
RetryThe dashboard is busy
Retrying automatically…