Skip to the page
Get started free

Every Code

Add SpecStream to Every Code with one table in ~/.code/config.toml, and the terminal agent can search the live web, read whole pages and build lists of records. Every Code is a community fork of OpenAI's Codex CLI, so the table has the shape Codex uses.

SpecStream for Every CodeCoding agents

What you need

  • Every Code, installed with npm install -g @just-every/code. If another code command is on your machine, such as VS Code's, run Every Code as coder.
  • A SpecStream account. New accounts get $10 of credit, no card. Create one.

  1. 1. Create an API key

    In your SpecStream workspace, open Agents & API, choose API keys, then Create API key, and set a total spending limit. Copy the key from the next screen. SpecStream shows it once.

    Put it in your shell profile, so the shell that starts Every Code has it:

    ~/.zshrc or ~/.bashrc
    export SPECSTREAM_API_KEY="YOUR_SPECSTREAM_API_KEY"

  2. 2. Add the SpecStream table to config.toml

    Every Code reads MCP servers from [mcp_servers.<name>] tables in ~/.code/config.toml. A table with a url connects over Streamable HTTP, which is how SpecStream's server at https://api.specstream.ai/mcp works.

    bearer_token_env_var names the environment variable that holds the key. Every Code reads the key from it and sends it as a bearer token, so the key never sits in the file:

    ~/.code/config.toml
    [mcp_servers.specstream]
    url = "https://api.specstream.ai/mcp"
    bearer_token_env_var = "SPECSTREAM_API_KEY"

  3. 3. Check the server

    Run code mcp list. SpecStream is in the list with its address. In a session, type /mcp to see every server with a switch to turn it on or off, or /mcp status for the list.

    Terminal
    code mcp list

  4. 4. Ask Every Code

    Ask for something current and name SpecStream. Every Code calls search_web for a quick answer and read_pages for the full text of the pages it found:

    In an Every Code session
    Use SpecStream to find the current stable release of Node.js and read its release notes.

What Every Code gets

SpecStream's server adds these tools to Every Code.

  • search_web answers a question from the live web, with up to 10 results for $5 per 1,000 searches. A search that returns nothing costs nothing.
  • read_pages returns the main text of up to 20 pages or documents (PDF, Word, Excel) in one call, at $0.80 per 1,000 pages. A page that gives no text is not charged.
  • Deep Search builds a list from a request in plain words. compile reads the request, quote_capacity_work prices it for free, and authorize_capacity_work starts it only after you approve the maximum. get_find and list_find_rows read the rows, each with its source URL and read time.

Or the stdio package

Every Code also starts local servers from a command. SpecStream's stdio package forwards to the same server. It needs Python 3.12 or newer: pip install specstream-mcp-stdio.

Every Code passes only a short list of variables to a server it starts, such as HOME, PATH and SHELL, so SPECSTREAM_API_KEY from your shell does not reach it. Set the key in the table's env. The key then sits in the file in plain text, so the url table above is the better choice wherever it works. If specstream-mcp-stdio is not on your PATH, put its full path in command.

Or sign in in the browser

To use your SpecStream sign in in place of a key, add the server by its address only. With no --bearer-token, Every Code saves the server as a stdio launcher that runs npx -y mcp-remote https://api.specstream.ai/mcp, and mcp-remote handles SpecStream's OAuth sign in in your browser. It needs Node.js, which the npm install of Every Code already has.

Do not pass your key with --bearer-token: Every Code then writes it into config.toml in plain text. Use the bearer_token_env_var table instead.

Keep paid work out of Every Code

Each server table takes enabled_tools, a list of the tools Every Code may use, and disabled_tools, a list it may not. To let Every Code search and read pages but never start paid Deep Search work, add one line to the SpecStream table. SpecStream keeps its own gate as well: nothing paid starts until you approve the price it quotes.

Every Code and Codex

Every Code reads ~/.code/ and the older ~/.codex/, and writes only to ~/.code/. Put the SpecStream table in ~/.code/config.toml, so Codex keeps its own settings if you switch back. CODE_HOME moves the config folder.

If you use Codex too, the Codex CLI guide adds SpecStream there with codex mcp add.

Timeouts

Every Code waits 10 seconds for a server to start and list its tools, and 60 seconds for a tool call. read_pages gives each page up to 30 seconds, all pages at once, so the defaults hold. To change them, set startup_timeout_sec or tool_timeout_sec in the specstream table.

Search quality

SpecStream's Search API scores 97.9 F-score on all 1,000 SimpleQA Verified questions and 64.0 item F1 on all 200 WideSearch tasks. Scores and method are on the benchmarks page.

Cost

Connecting SpecStream to Every Code is free, and new accounts start with $10 of credit, no card. Searches and page reads come out of your balance per call, with no quote. A Deep Search row costs 5¢, 15¢ or $1, depending on what the row needs, never more than the maximum you approved, and a run that finds nothing costs nothing. Balance and billing has the details.

Remove

Run code mcp remove specstream, or delete the table from ~/.code/config.toml. To stop the key working everywhere, revoke it in Agents & API. More coding agents are in Connect your tools. Questions go to [email protected].

More

SpecStream for Every Code covers what it does in Every Code on one page. Every other tool has its guide in Connect your tools. You see the most a request can cost before it starts, and the matches are paid from your balance. Billing has the details. For help, email [email protected].