Suncode

Suncode is an engineering workflow layer for AI coding agents. It keeps project specs, task context, workflow state, and session memory in your repository so agents can work with durable project knowledge instead of starting from scratch every time.

简体中文 · Documentation · Marketplace

What Suncode Provides

• Project specs: keep coding conventions and architectural rules in versioned project files.
• Task workflow: structure AI work around PRDs, implementation context, checks, and task state.
• Session memory: preserve useful session notes so future work can reuse real project context.
• Multi-platform setup: generate integration files for the AI coding tools you use.
• Optional Hub workflow: connect local project tasks to Suncode Hub for team requirement and task coordination.

Requirements

• Node.js 18+
• Python 3.9+
• git

Install

npm install -g @wjptz/suncode@latest

For local development in this repository:

pnpm install
pnpm --dir packages/cli build
pnpm --dir packages/cli link --global

Quick Start

Initialize Suncode in a repository:

suncode init -u your-name

Initialize only the platforms you use:

suncode init --cursor --opencode --engineer --codex --grok --kimi -u your-name

Oh My Pi is supported through suncode init --omp -u your-name. A pre-existing .omp/ directory is only treated as Suncode-managed when it contains a Suncode ownership marker, so unrelated OMP assets remain untouched.

Then follow the generated workflow files and commands in the target repository.

Common Commands

suncode --help
suncode init --help
suncode update --help
suncode uninstall --help
suncode platforms --json
python3 ./.suncode/scripts/task.py current --json
python3 ./.suncode/scripts/task.py list --json

Hub commands:

suncode hub init
suncode hub login
suncode hub state
suncode hub logout

Development Checks

pnpm --dir packages/cli typecheck
pnpm --dir packages/cli lint
pnpm --dir packages/cli test
pnpm --dir packages/cli build

Resources

• Documentation
• Marketplace
• npm package
• GitHub issues
• License