Package Exports

@nocodeveloper/zoe-cli
@nocodeveloper/zoe-cli/dist/cli/index.js

This package does not declare an exports field, so the exports above have been automatically detected and optimized by JSPM instead. If any package subpath is missing, it is recommended to post an issue to the original package (@nocodeveloper/zoe-cli) to support the "exports" field. If that is not possible, create a JSPM override to customize the exports field for this package.

Readme

ZOE CLI

Understand your project before AI does.

Zoe analyzes your project before generating code. It helps developers understand, plan and safely build software directly from the terminal.

Status: Public Preview Current npm latest: 2.5.3 Project milestone: v0.1 Public Preview

Website · Docs · Roadmap · Changelog

Installation

npm install -g @nocodeveloper/zoe-cli

Quick Start

cd my-project

zoe

Login with GitHub — one-time OAuth setup
Start building — chat or run tasks

Features

GitHub Login — one command, no tokens to copy
No API Keys — OpenRouter, AI gateway, secrets all handled by Zoe Cloud
Project Intelligence — scans structure, language, and dependencies automatically
Execution Planning — every task gets a plan before code is written
AI Chat — streaming responses in the terminal
Create Files — full content generated and saved
Edit Existing Code — targeted edits that preserve the rest of the file
Safe File Editing — edit_file fails fast if your target text is ambiguous
Zoe Cloud — your session, memory and secrets live in your private cloud
Built in Public — every release is shipped from a public, traceable commit

How Zoe Works

Understand    Read your project: files, stack, dependencies
     ↓
Plan          Generate an execution plan, with risks and steps
     ↓
Build         Write and edit code, run commands, apply changes
     ↓
Review        Verify the result and surface any warnings

You see every step. Zoe never edits a file without telling you first.

Example

$ zoe

Welcome back, Joel. You are signed in to your project.
Model: deepseek/deepseek-v4-flash

> Analyze this project

Reading workspace...
Planning...
  ✓ Scanned 47 files, 12 dependencies
  ✓ Identified: TypeScript, Node, Express
  ✓ Detected 2 critical config files (package.json, tsconfig.json)

Building...
  ✓ Created src/routes/api.ts
  ✓ Edited src/server.ts (added 12 lines)
  ✓ Created tests/api.test.ts

Reviewing...
  ✓ All imports valid
  ✓ No TODOs / placeholders

Completed in 14s. 3 files changed.

Roadmap

✅ v0.1 Public Preview — current
🟡 v0.2 Better Terminal UI — interactive TUI, inline diffs, multi-pane
🟡 v0.3 Project Intelligence — semantic search, dependency graph, hotspots
🟡 v0.4 Zoe Cloud — sessions, history, shareable workspaces
⚪ v1.0 Stable — API freeze, plugin SDK, enterprise auth

See the full breakdown in ROADMAP.md.

Building in Public

Zoe is being developed in public. Every commit, every decision, every failed experiment is part of the journey. If that resonates with you, follow along:

Contributing

We welcome issues, feedback, and pull requests. See CONTRIBUTING.md for setup, coding style, and how to submit a PR.

For community standards, see CODE_OF_CONDUCT.md.

Security

Found a vulnerability? Please report it privately — see SECURITY.md.

License

_{Zoe is an independent open-source project. AI inference is powered by InsForge and routed through the AI gateway configured for your account.}