Skip to content

npm i -g futurex-cli

The AI coding agent for your terminal

FutureX is a CLI AI coding assistant that works where you already work. Describe the change in plain English — it reads the codebase, plans the job out loud, writes the code, and ships a preview. You stay in the shell the whole time.

Node 20+ · Windows, macOS, Linux · free first month

01Live session

An AI pair programmer that reads before it writes

One prompt, one loop. FutureX opens the files it needs, states the plan, makes the edits, runs your checks, and hands back a preview. When it recognizes something from an earlier session, it says so instead of building it twice.

  • REPO-AWARE
  • WRITES ARE GATED
  • SHIPS PREVIEWS
futurex — ~/api
fx>add rate limiting to the public api
read 14 files · routes/ · middleware.ts · lib/redis.ts
plan: token bucket · per-key budget · 429 + Retry-After
✓ lib/rate-limit.ts — token bucket, redis-backed (+71 −0)
✓ middleware.ts — runs ahead of the route table (+18 −2)
✓ memory: api keys are hashed in lib/keys.ts — reused
✓ typecheck · lint · tests 24/24
✓ shipped to preview · 41s

02How it works

Read the repo. Plan. Build. Ship a preview.

A vibe coding tool is only worth the code it understands. FutureX runs the same four beats every time, and every beat is a command you can run on its own.

01Read

It reads the repo first

futurex index builds a retrieval index over your project. futurex symbols answers where a thing is defined, futurex imports shows what it touches and what is broken. Context before keystrokes.

futurex index

02Plan

It plans out loud

futurex plan writes the goal, the value and budget, the research it needs, the tooling, and a task DAG. You read the plan and argue with it before a single file moves.

futurex plan "…"

03Build

It builds against the plan

futurex build executes that plan step by step. Reads run on their own; every write asks for consent unless you have granted it a standing rule in .futurex/settings.json.

futurex build "…"

04Ship

It verifies, then ships

After the edits land it runs typecheck, lint, and tests, then ships straight to preview. Pass --no-verify when you want the checks skipped, and futurex verify to run them on demand.

futurex verify

03Project memory

It remembers your codebase between sessions

FutureX keeps one file at the root of your repository: futurex-memory.md. It is the agent's notebook — the decisions it made, the shape of the project it learned, written down in plain markdown. Close the terminal, come back next week, and the next prompt starts where the last one ended.

That is the difference between a chat window and a terminal AI coding agent: you stop re-explaining your own codebase every morning.

  • futurex init creates futurex-memory.md at the repo root if it is missing.
  • futurex compact regenerates and archives the file once it outgrows its budget — roughly 7,000 tokens.
  • It is ordinary markdown: read it, edit it, commit it, review it in a pull request like any other file.
  • --no-memory ignores the file for one run, when you want a clean-room answer.
How project memory works
futurex init
# creates futurex-memory.md at the repo root if it is absent
futurex compact
# regenerate and archive the file when it grows past its budget
futurex agent "rename the auth module" --no-memory
# one run with the memory file ignored

04Install

One line, any terminal

FutureX ships as a single global CLI on Node 20+. Install it with the package manager you already use, sign in once through your browser, and run futurex from any project — Windows, macOS, or Linux.

Prefer one-shot? futurex ask answers and exits. futurex agent takes a task and uses tools to finish it — reads run on their own, writes ask first. The command reference has every command and flag.

Node 20+Free first monthNo card required

npm i -g futurex-cli
# sign in once, then open the REPL
futurex loginfuturex

05Pricing

You pay for tokens, not for seats

No subscription, no per-developer licence. Two published rates, billed by what you actually use — and the first month is free while you find out how much that is.

Fast

The default module. Everyday edits, refactors, and answers about your repo.

$1per 1M tokens

Free first month · no card

  • Runs by default in every session
  • Up to 16,000 output tokens per reply
  • Reasoning off by default, --reason when you want it

Pro

For the hard ones — long plans, wide refactors, bugs that hide.

$2per 1M tokens

Free first month · no card

  • Maximum reasoning effort by default
  • Up to 64,000 output tokens per reply
  • Switch per run with --pro or --tier fx-pro
Start free

Light and Eco round out the lineup — compare all four in the models reference.

Would rather not build it yourself? The FIM studio takes the brief, quotes a fixed scope, and delivers it for you — same platform, same account.

futurex login

Install it, then give it something hard

One command to install, one browser sign-in, and the agent is in your repo. The first month is free, and there is no card to hand over first.

npm i -g futurex-cli · Node 20+ · $1 per 1M tokens after launch month