GenCode

What is GenCode?

GenCode is Genspark's coding agent. It works on code in a directory you choose. Pick between a Chat UI and a Terminal UI — the same product with the same capabilities, whichever style you prefer — and you can run it in two places:

• The GenCode workspace in the Genspark Super App — the desktop surface. You work with the agent in a conversation, and the prompt composer shows the model in use, your context usage, and credits.
• The standalone GenCode CLI — a terminal program you install with npm and run from the directory you want to work in.

Both run the same engine, the same Genspark-hosted model catalog, and the same billing. GenCode is built on Genspark's fork of OpenCode, and it keeps its own configuration directories, so it does not touch an existing OpenCode install.

Quick Start

In the Genspark Super App

1. Update the Genspark Super App to the latest version.
2. Open the app and look for the GenCode workspace. If you don't see it, click + in the tab bar and add it.

No Super App yet? Download it here. It is a free download for macOS, Windows, and Linux. On Mac, the Super App requires Apple Silicon.

With the CLI

1. Install it: npm i -g @genspark/gencode
2. Sign in: gencode login — this opens a device-flow sign-in. Once signed in, the CLI shows your balance, plan, and account email next to the model catalog.
3. Run it: gencode, from the directory you want to work in.

The CLI keeps the OpenCode command surface:

• gencode run --format json for scripted and non-interactive use
• gencode models to list the models available to you
• --dir, --session, and --model flags
• environment variables prefixed OPENCODE_

It keeps its own configuration directories — ~/.config/gencode, ~/.local/share/gencode, ~/.local/state/gencode, and ~/.cache/gencode — so an existing OpenCode install is untouched.

The CLI binaries cover Intel Macs as well as Apple Silicon Macs, plus Windows and Linux.

Feature & How-To Guides

GenCode ships with a Chat UI and a Terminal UI. It is the same product with the same capabilities either way — use the one that fits how you work.

• The workspace. In the Genspark Super App, you work with GenCode in a conversation. The composer shows the model in use, your context usage, and credits.
• The CLI. The same agent in your terminal, as a full-screen interface with panels for session context and code diagnostics.
• A coding agent either way. GenCode works on the code in a directory you choose. Actions run through tool calls, and the results are text and file changes.
• Sub-agents. GenCode handles larger tasks through sub-agents — one that reads and analyzes, and one that can make changes. Each has a configured step limit, so a run stays bounded.
• Ratings. In the Super App, you can rate any GenCode turn with a thumbs up or thumbs down. Ratings stay on your machine.
• Your feedback stays local. A rating describes the turn it came from — model, tools used, files and lines changed, tokens, cost, and time. Any free-text comment you write is never transmitted.
• Scriptable and CI-friendly. gencode run --format json returns machine-readable output you can pipe into scripts and pipelines.

Find your project folder

A project is a local folder you add to GenCode, and GenCode works on the code in that folder. The built-in project shows as GenCode; its folder is GensparkCode in your home folder, created the first time you use it.

Remove from list only takes a project out of GenCode's list, so its files stay on disk and its chats stay in GenCode's history. The icon in the project files panel (top right, beside Chat and Terminal) opens the selected file in its default app. In the CLI, your project is the folder you run gencode from, or the one you pass with gencode --dir <path>; see Quick Start. A session's Working directory (under Edit session) applies when the session is rebuilt or reopened, and Settings → Reset keeps your project folders on disk.

macOS

Click + next to Projects in the sidebar to open your folder picker, then choose or create a folder. The built-in project's folder is /Users/<you>/GensparkCode. To find any project's folder, open the project's Project actions menu and choose Reveal in file manager to open it in Finder, or Copy path.

Windows

Click + next to Projects in the sidebar to open your folder picker, then choose or create a folder. The built-in project's folder is C:\Users\<you>\GensparkCode. To find any project's folder, open the project's Project actions menu and choose Reveal in file manager to open it in File Explorer, or Copy path. The Terminal tab opens PowerShell, and the Super App downloads as a .exe installer.

Linux

Click + next to Projects in the sidebar to open your folder picker, then choose or create a folder. The built-in project's folder is /home/<you>/GensparkCode. To find any project's folder, open the project's Project actions menu and choose Reveal in file manager to open it in your file manager, or Copy path. The Super App ships as an AppImage.

Models & cost

Models. GenCode uses a Genspark-hosted model catalog spanning nine model families: Claude (Anthropic), GPT (OpenAI), Gemini (Google), DeepSeek, GLM (Z.ai), MiniMax, Kimi (Moonshot AI), Grok (xAI), and Nemotron (NVIDIA).

Cost. GenCode runs on Genspark credits. Usage is billed to the account GenCode authenticates with. In the CLI, if GSK_API_KEY (or GSK_BASE_URL) is set in your environment, the key's account is billed instead. In your credit history, GenCode usage appears as "GenCode".

GenCode is billed straight to credits, rather than through the Free Quota that covers Standard-mode agent tasks — see Membership Plans.

There is no separate GenCode subscription or wallet — it uses your existing Genspark account and credits. For how credits work, see the Credits Guide.

FAQ

Is GenCode the same as Genspark Code?

No. Genspark Code is the browser agent at genspark.ai/code that builds complete applications from a prompt — see the Genspark Code help article. GenCode is the coding agent described here.

Is GenCode the same as Genspark Claw?

No. Claw is Genspark's personal-assistant agent that operates your apps and files, not a coding agent.

What about GenTerminal?

GenTerminal is Genspark's standalone terminal app — a different product.

Do I need the Super App to use GenCode?

No. You can use the GenCode workspace in the Genspark Super App, or install the standalone GenCode CLI. Both are the same agent.

What is the difference between the workspace and the CLI?

Just where you run it. The workspace runs inside the Genspark Super App; the CLI runs in your terminal. Same agent, same capabilities.

Do I need a paid plan?

No. GenCode uses your existing Genspark account and credits. There is no separate GenCode subscription or wallet.

Does GenCode cost credits?

Yes. GenCode is billed to the account it authenticates with — by default the account you signed in with. In the CLI, if GSK_API_KEY is set in your environment, the key's account is billed instead. Usage appears as "GenCode" in your credit history, and GenCode is billed straight to credits rather than through Free Quota.

Which models does GenCode use?

A Genspark-hosted catalog spanning nine model families: Claude (Anthropic), GPT (OpenAI), Gemini (Google), DeepSeek, GLM (Z.ai), MiniMax, Kimi (Moonshot AI), Grok (xAI), and Nemotron (NVIDIA). Which specific models your account can use depends on the live catalog and your organization's AI-vendor policy.

Will the CLI interfere with my existing OpenCode install?

No. GenCode is built on Genspark's fork of OpenCode, but it installs its own binary and keeps its own configuration directories (~/.config/gencode, ~/.local/share/gencode, ~/.local/state/gencode, ~/.cache/gencode). It never touches an existing OpenCode install.

Does GenCode work on an Intel Mac?

The CLI does — its published npm packages include Intel macOS (darwin-x64). The Super App requires Apple Silicon on Mac. Windows and Linux are supported for both.

Where do I download the Genspark Super App?

superapp.genspark.ai/download — free download for macOS, Windows, and Linux.

Where is my GenCode project folder?

Open the project's Project actions menu and choose Reveal in file manager, or Copy path — see Find your project folder.