mrkeyoor.com_
Thu 24 Sept 17:22 UTC
AI Toolsevaluationupdated 24 Sept 2026

Step-Code review

Step Code is an open-source coding agent that reads and edits a project from a terminal, runs commands, and can continue long jobs through goals and scheduled tasks. Its default entry point uses StepFun's model service, while MCP servers, Agent Skills, and many Claude Code plugins extend what the agent can do.

Verdict

Our Step Code run installed 304 packages, built successfully, and passed all 15 tests, making it a credible trial for developers already using Step's model service. Keep it inside a trusted workspace or your own container because the project explicitly provides no sandbox, and review the open command-policy and MCP environment reports before granting broad access. Native Windows users should wait for the current build and migration issues to settle or use the recommended WSL route.

We ran it

Lab card: what happened when we ran Step-CodeScreenshot of Step-Code (github.com/stepfun-ai/Step-Code)
Install✓ · 22s304 packages · 289 MB
Build✓ · 18s
Tests✓ · 444s15 passed · 0 failed of 15 (vitest)
Repo1407 files~301,231 lines of source · 14.9 MB · 3 CI workflows

Answers from our run

Does Step-Code build from source?

Dependencies installed in 22 seconds (304 packages), and the build succeeded in 18 seconds. We cloned commit 7dd66cb into a clean Debian container with 3 CPUs and no project-specific setup.

Do Step-Code's tests pass?

Yes: 15 of 15 passed when we ran the project's own test command (vitest). Some failures need services or credentials a bare container does not have.

Who should not use Step-Code?

Developers who want a built-in choice of model vendors: the README says the default Step Code entry point has one built-in provider, Step.

What are the alternatives to Step-Code?

OpenAI Codex, Gemini CLI, Claude Code. Our Step Code run installed 304 packages, built successfully, and passed all 15 tests, making it a credible trial for developers already using Step's model service.

Setup4/522-second install and passing build; Step credentials still required
Docs4/5Detailed internals, though several README links remain placeholders
Community4/5390 stars and 41 open issues and PRs with same-day activity
Maturity3/5Core checks pass, but Windows and permission reports remain open

Who it’s for

Developers who already pay for Step Plan or use a Step Platform API key.
Terminal users who want an agent to edit files, run tests, resume sessions, and publish static sites.
Teams willing to contain an unsandboxed coding agent inside a trusted repository or separate environment.
MCP and Claude Code users who want to reuse existing servers, skills, or compatible plugins.

Who it’s NOT for

Developers who want a built-in choice of model vendors: the README says the default Step Code entry point has one built-in provider, Step.
Anyone expecting the agent itself to isolate commands: the security policy says Step Code intentionally has no sandbox and treats writable local files as trusted.
Native Windows users who need a settled source-build path: Windows support is labeled beta, and open issue 151 reports a build failure plus a session-migration bug.
Teams that cannot review subprocess secrets: open issue 191 shows local stdio MCP servers inheriting the full parent environment, including a path that can add stored Step credentials.
Operators relying on confirmation rules as their only destructive-command control: open issue 130 documents common command forms that the current rules classify as ordinary.

Setup reality

Our sandbox installed 304 pnpm packages in 22 seconds and used 289 MB. The build succeeded in 18 seconds. Tests also succeeded: Vitest passed all 15 tests in 444 seconds. The checkout contained 1,407 files and about 301,231 source lines.

Running the agent requires Node.js 22.19 or newer and pnpm 9.15.9 from source. Useful model work needs a Step Plan browser login or a Step Platform API key. MCP servers and plugins may bring their own commands, credentials, and configuration.

The project is a workspace monorepo with 3 CI workflows but no Dockerfile or top-level tests directory. Windows PowerShell support is beta, with WSL recommended. Step Code has four permission modes, but its own security policy says the agent is not sandboxed.

Step Code binds a terminal agent to one built-in provider

Step Code's default CLI has 1 built-in model provider: Step. The agent can inspect a repository, edit files, run commands, resume sessions, and keep working through an explicit goal. You sign in through a Step Plan account or supply a Step Platform API key, then choose among the models returned by that service. This is a good fit if Step already handles your model access. It is a poor reason to switch providers on its own.

The terminal interface covers interactive work and headless prompts. It can import MCP settings from Claude Code or Codex, read an existing CLAUDE.md, and generate AGENTS.md. A bundled StepPage plugin publishes a local directory as a static site with versions and rollback. Those integrations make the agent useful beyond chat, but each one increases what the local process can read or execute.

The source checkout passed, while the full suite took 444 seconds

The repository is much larger than the short installation instructions suggest. commit 7dd66cb contained 1,407 files and roughly 301,231 lines of source in a 14.9 MB checkout. It is a pnpm workspace spanning the CLI, terminal UI, provider code, configuration, telemetry, and the coding-agent runtime. Our scan found 3 CI workflow files, no Dockerfile, and no top-level tests directory.

Source setup is still straightforward. The documented path needs Git, Node.js 22.19 or newer, and pnpm. Its root package pins pnpm 9.15.9 and chains builds across the workspaces. The public tree can create local release bundles, but the project's open-source status document says publication credentials and protected release operations live elsewhere. GitHub's latest-release endpoint returned no release object when we checked.

What happened when we ran it

Our sandbox installed 304 packages in 22 seconds and occupied 289 MB on disk. The build completed successfully in 18 seconds. This was a fresh, unprivileged Debian container with 3 CPUs, 8 GB of RAM, Node 22, and no secrets. The result shows that the checked-out source can be assembled without a Step login.

Vitest passed all 15 tests, with 0 failures, in 444 seconds. That is a clean result, though the test step took far longer than the install and build combined. We did not sign in, ask a model to edit a repository, connect an MCP server, publish through StepPage, or assess generated code. The run proves the measured repository checks passed, not that autonomous changes are safe.

Four permission modes still sit outside a sandbox

Step Code has 4 permission modes, and its security policy says the agent is not sandboxed. Ask, Read Only, Bypass, and Autopilot control when Step Code requests approval. Built-in dangerous commands are meant to require a separate confirmation even in permissive modes. The policy assumes trusted repositories and extensions, and it treats files writable by your user account as inside the same trust zone. Run it in a container or virtual machine if that boundary is too broad.

Open issue 130 matters here. Its reproduction says forms such as git push -f, reordered dd arguments, and systemctl poweroff can miss the dangerous-command patterns and be classified as ordinary under the default Bypass preset. The report is open, so treat it as a current warning rather than a fixed incident. A confirmation regex should not be your last barrier against destructive model output.

MCP compatibility can pass parent secrets to local servers

Step Code imports MCP settings from 2 clients, Claude Code and Codex, on first launch. Interactive sessions start discovery in the background, and the README says most Claude Code plugins work directly. That makes migration easy, and it earns both the MCP and Claude Code labels. It also means third-party server commands and plugin instructions run inside the same local trust boundary as the agent.

Issue 191 reports that a local stdio MCP subprocess receives the full Step Code environment instead of the MCP SDK's smaller default set. The supplied reproduction used 1 synthetic variable and found it in the child process. The same code path can add a stored Step credential when STEPFUN_API_KEY is absent. Until maintainers resolve the report, declare MCP environments narrowly and avoid launching unreviewed servers beside unrelated secrets.

Windows is beta, and WSL is the safer documented route

The README labels PowerShell support beta and recommends WSL. Its installer covers 4 environments, macOS, Linux, WSL, and Windows PowerShell, verifies a checksum, and places the binary under ~/.stepcode/bin by default. Open issue 151 gives the beta label teeth: its reporter found native Windows source builds failing at an npm spawn and a session migration silently leaving files behind.

The issue queue is active enough to make these reports useful rather than archaeological. GitHub showed a push on September 24, 2026, 390 stars, and 41 combined open issues and pull requests. Several reports and proposed fixes were updated that same day. There is no GitHub release record to compare with the source activity, so use the installer version output and pinning option when repeatable setup matters.

Step Code has earned a trial if you want Step models in a capable terminal agent. Our 15 passing tests remove one source-level concern, but they do not cancel the product's stated trust model. Put the agent where a mistaken command cannot reach everything you own, inspect every MCP server, and choose WSL over native Windows until the open build path is repaired.

Alternatives

ProjectWhat it isPick it when
OpenAI Codex gh↗A terminal coding agent built around OpenAI models with local command controls and MCP support.pick this instead when OpenAI is your model provider and you want its coding-agent workflow rather than Step Plan integration.
Gemini CLI gh↗Google's open-source terminal agent for Gemini models, tools, and MCP servers.pick this instead when your account, billing, and model choice already sit with Google.
Claude Code gh↗Anthropic's terminal coding agent and the plugin ecosystem Step Code aims to accept in part.pick this instead when native Claude behavior and first-party plugin compatibility matter more than Step models.

What people are saying

  1. [github-trending] stepfun-ai/Step-Code

Sources

  1. Step Code README
  2. Step Code security policy
  3. Step Code command permissions
  4. Dangerous-command matching report
  5. MCP subprocess environment report
  6. Native Windows build and migration report

More ai tools reviews

monty · agenticSeek · starnet · lap · stable-diffusion.cpp · Model-Optimizer · the whole board →