Skip to content

The dashboard

The dashboard runs on your own computer at http://localhost:8870 (or the port you chose). Every field has a small i: hover it for a preview, tap or click it for the full explanation.

The dashboard: header, totals and an agent's page

  • Getting started reopens the guide to your keys, funding and going live.
  • Keys holds the AI, Telegram and Binance keys for all agents (Your keys).
  • Go LIVE / Back to dry run is one switch for all agents. Going live asks you to type GO LIVE and your password; back to dry run is one click.
  • Kill switch stops every agent at once. Turning it on is one click; releasing it asks for your password.
  • The version you run is the small label next to the mode, for example v1.0.0. Its i explains updates. The round arrow next to it, Check for updates, asks GitHub now instead of at the next check, and the notice and a short message give the answer. It installs nothing. It is off while an update installs and not shown where the check is switched off.
  • The update notice appears under the header when a newer version is out: about every 10 minutes the agent asks GitHub for the newest release. It shows the new version, the one you run and what is new. Update now installs it in one click and needs no password; on Telegram, /upgrade does the same. While it installs, the notice says so and the page comes back by itself after the restart. An agent started by hand with ./run.sh does not restart by itself: there the notice says that the new version is in place and how to start it. For a day it then shows how the update went: done, not installed (with why) or undone because the new version did not start. It shows that only while the version it speaks of still runs: after you install another version by hand or from a terminal it goes. After an undo nothing has to be done: the notice says so. While that same version is on offer its button reads Try again, to install it once more only if you want to. When the background service was set up by an older installer, the notice may say to run ./install.sh --update once in a terminal: it then offers no Update now, which would fail the same way, until that is done (Troubleshooting). An install that cannot update itself shows what to do instead of the button (Update).
  • The manual notice appears under the header when the check found that FoxLeague’s manual changed since the copy your agents play by (it names up to eight pages and counts the rest) or could not read it (it says why). It also names a setting FoxLeague’s game settings gained or lost since that copy and a route of FoxLeague’s API your agents call whose shape changed. Nothing shows while the copy matches. Its i says what to do (Update).
  • Agents: how many agents are active on this computer, how many are paused, how many are retired and how many are low on funds.
  • EGLD and FOXSY: the live prices. Every payment is valued in USD before it is checked; FOXSY counts at the higher of its spot price and its two-day median, so a sudden dip never makes a payment look cheaper.
  • Spent today: what all agents spent this game day (it resets at 14:00 UTC, like the game’s own daily limits).
  • Strategist: the AI model and effort for every agent that has no model or effort of its own, from four models: Haiku 5.5, Sonnet 5.5, Opus 5.5 and Fable 5.2. Below it, how many agents use their own. Haiku 5.5 at high effort is the default and plays well at the lowest cost. Sonnet 5.5 plans more carefully and acts less; Opus 5.5 is the most active and costs the most of the three. Fable 5.2, the most capable, costs more still. A higher effort thinks harder and costs more. A dearer model or a higher effort asks for your password, because the AI spend has no cap of its own; a cheaper one is one click. A switch that starts shadow plans asks for the password too (What it costs). The entry “Local model (free, coming soon)” at the top of the list cannot be picked: a free model that runs on your own computer is being tested and is not ready. Without the AI key the box is greyed out: it shows the model and effort the agents start on once the key is set (Haiku 5.5 at high on a new install), and the level’s recommended AI is shown next to the level. Under it, When FoxLeague changes its rules: tell me only (the default) or also pause the actions whose rules changed until the agents are synced; while a pause holds something, the line under it names the actions. Pausing is one click; going back to tell me only asks for your password (Update).
  • Controls: Plan now runs a planning cycle at once; Pause stops this agent only; Retire parks an agent you no longer use (see below).
  • Wallet and team: the EGLD, WEGLD and FOXSY balances (WEGLD shows 0.0000 when the wallet holds none), cards, team, rating and record, matches and training today. While the page is open, a reading older than 10 minutes is taken again by itself, so a top-up shows within seconds (Refresh reads it at once). Value is what the wallet’s EGLD, WEGLD and FOXSY are worth in USD, and next to it what the agent can play with (the EGLD gas reserve aside); it turns orange, and the agent’s tab shows low funds, when that falls under your Top-up warning (it shows in the morning summary on Telegram, at once with /updates all; with a Binance key, Telegram and the platform LIVE, a top-up proposal comes at once (once a day per agent)). To top up, send EGLD to the agent’s address: it buys FOXSY by itself (WEGLD and FOXSY work too). In tournaments lists the tournaments and 1v1s the agent is in, each open one with a Leave button (once FoxLeague’s leave lock is on, a tournament exactly at its minimum number of teams cannot be left).
  • Last plan: the agent’s latest reading of the situation, each action with a one-line reason and the cost of the AI call.
  • Activity: everything the agent did, newest first, with a filter for plans, actions or problems. A row marked “shadow plan, not carried out” is what another AI model would have planned, recorded only to compare (What it costs). A shadow plan by the agent’s own model and effort says so: it is the same model planning the same request a second time.
  • Budget: spend against today’s cap, this month’s budget and the setup budget.
  • Talk to the manager: advice or questions in plain words, typed or spoken (Talk to your manager).
  • Settings: the strategy, the agent’s own AI model and effort (or the same as all agents) and every limit (Every setting explained). An agent with its own AI shows it on its tab.

Above the pages, a tab per agent shows its number and team. + Add agent adds one from your recovery words; Import team adds one for a team you already play, marked imported, which also gets a Remove button on its page (Import your team).

An agent's plan, budget and settings

An agent you no longer use can be parked, so only the ones that play stay in the tabs. On its page, press Retire and confirm. The agent is paused and moves to Retired, a button next to Import team that shows how many agents are parked there.

Retire: the agent is paused and moves to Retired

A retired agent makes no plans, costs nothing, sends no warnings and does not count toward the agent limit, so it frees its place for a new agent. Nothing is sold or moved: the wallet keeps its funds and cards, the team stays in FoxLeague (tournaments it already joined go on without it) and an imported team keeps its key. An agent cannot be retired while a payment waits for FoxLeague’s confirmation.

Retired lists each parked agent with its team, wallet address, the day it was retired and what the wallet held then. Restore brings it back to the tabs with its settings and history, paused: check its limits, then press Resume. Restore needs a free place under the agent limit.

Retired: the parked agents, each with Restore

On Telegram, /status names the retired agents, and commands for one of them answer that it is retired. Restore is in the dashboard only.

An agent you added but never used, with a wallet that sent no transaction, holds nothing (no EGLD, WEGLD, FOXSY or cards) and has no FoxLeague team, can be deleted instead of retired. Its page then shows Delete, next to Retire. Before anything goes, the wallet is read again from the chain and FoxLeague; if any of it is not clean or cannot be read, nothing is deleted.

The agent, its settings and its history are deleted, and so is its PEM file in pem/. On a server install the PEM files are on your computer: run ./deploy/sync-pems.sh there and it removes the files of the deleted agents. Nothing is lost, because the wallet is empty and comes from your recovery words: + Add agent takes the lowest free number, so it makes the same wallet again. An agent that was ever used is retired, never deleted.

The dashboard listens on your computer only, never on the internet. To open it from another device, use an SSH tunnel (ssh -L 8870:localhost:8870 you@your-computer), or follow the agent on Telegram.