NemesisCode is a terminal-native AI coding assistant. It can read and write code, run commands, manage Git, and use a persistent memory system to keep a deep understanding of your project across sessions while continuously improving itself.

NemesisCode supports connecting to any mainstream LLM provider API, including self-hosted and OpenAI-compatible gateways. The published CLI is distributed under the user-owned @pooraddyy/nemesis-cli package.

Quick Start

# Recommended install (all platforms)
npm install -g @pooraddyy/nemesis-cli

# One-off run without a global install
npx --yes @pooraddyy/nemesis-cli

# Or, from an authenticated clone of this private repository:
# ./install        # macOS / Linux
# ./install.ps1    # Windows PowerShell

# Run
nemesis

The first launch guides you through configuration automatically. Supported options:

• Nemesis provider — configure your own OpenAI-compatible endpoint and model IDs
• Codex (ChatGPT Pro/Plus) — OpenAI OAuth login
• Import from Claude Code — migrate existing authentication in one step
• Provider list — connect catalog providers by API key, or OAuth where supported
• Custom Provider — add any OpenAI-compatible API in the TUI

Core Features

• Multiple Agents — build (default), plan (read-only analysis), compose (specs-driven orchestration); press Tab to switch
• Persistent Memory — cross-session project knowledge, checkpoints, and task progress powered by SQLite FTS5
• Intelligent Context Management — automatic checkpoints, context reconstruction, and budgeted injection to stay within model limits
• Task Tracking — tree-shaped task system integrated with the checkpoint system
• Subagent System — parallel subagents with lifecycle tracking, cancellation, and background execution
• Goal / Stop Condition — judge model prevents premature stops during autonomous work
• Compose Mode — structured workflow for specs-driven development; recommended via the /compose-next skill on the build agent
• Builtin Skills — 20+ reusable instruction sets (PDF/Office generation, research, design, and more), invoked via /skill-name or auto-matched by relevance
• Workflows — deterministic multi-agent orchestration scripts, including built-in compose, deep-research, fact-check, and research-experiment pipelines
• Voice Input — real-time streaming voice input powered by TenVAD and Nemesis ASR
• Dream & Distill — extract knowledge into memory (/dream) and discover reusable workflows (/distill)

For detailed documentation, configuration options, and troubleshooting, see the GitHub repository.

License

Source code is licensed under the MIT License.

Use of NemesisCode is also subject to the Use Restrictions. Use of the Nemesis name, logo, and trademarks is subject to the Nemesis Trademark Policy.