scion-toolkit

library1.0.0jsnpmunverified

Scion is an AI-powered migration toolkit for translating C/C++ codebases to Rust, currently at version 1.0.0. It runs on top of AI coding harnesses, supporting both Claude Code and OpenCode. Key differentiators include smart continuation, automatic task decomposition, static analysis of C sources, API mapping generation, and built-in code review gates. The toolkit provides 11 static and 4 runtime gates for pre-review checks, a dashboard at localhost:3456 for progress monitoring, and a knowledge base for recording migration patterns and pitfalls. It requires Node.js >= 18 and a Rust toolchain.

devops ai-ml

npm install scion-toolkit

package ↗

INSTALL

IMPORT

SIG · SCION-TOOLKIT

scion-toolkit

devopsjavascriptv1.0.0

harness data pending

Install & Compatibility

Where this runs

No compatibility data collected yet for this library.

Code

Verified usage

Complete setup and first migration workflow: install, init, monitor, and optionally intervene.

# Clone Scion # git clone https://github.com/ZhifeiDou/Scion-HW.git # Run installer (macOS/Linux/Git Bash) chmod +x /path/to/Scion-HW/install.sh /path/to/Scion-HW/install.sh --project /your/r/project # Or specify project directory directly # ./install.sh --project /path/to/project # Initialize migration cd /your/project claude /scion:init --source /path/to/c-project --target /path/to/rust-crate # Monitor progress at http://localhost:3456 or via /scion:status # If auto-continuation halts, run: # /scion:continue # To manually review deliverables: # /scion:review

Debug

Known issues

gotchaOpenCode (v1) does not support Scion hooks for dashboard auto-refresh and file ownership guards; only commands and agents are available.

fix

Use Claude Code for full functionality, or manually refresh dashboard via `node scripts/build-dashboard.js`.

affects: >=1.0.0

gotchaDo not run `/scion:init` inside the Scion repo itself; it must be run inside your migration project after install.

fix

Change to your project directory (cd /your/project) before running `/scion:init`.

affects: >=1.0.0

breakingInstaller overwrites files in `.claude/commands/`, `.claude/agents/`, and `scripts/` without prompting on name collision.

fix

Backup any custom commands/agents/scripts before running install.sh or install.ps1.

affects: >=1.0.0

Errors

Common errors & fixes

Error: Cannot find module '.../scripts/build-dashboard.js'

Installer did not copy scripts directory (manual install incomplete or --project flag missing)

fix

Re-run installer with correct --project path, or copy scripts/ manually to <project>/scripts/

command not found: scion

Scion commands are not available in the terminal directly; they are only available inside Claude Code or OpenCode after installation

fix

Run `claude` (or `opencode`) first, then use `/scion:init` etc. inside the AI harness.

Cannot read properties of undefined (reading 'cargo')

Missing Rust toolchain or cargo not in PATH; /scion:doctor precheck failed

fix

Install Rust toolchain: `curl --proto '=https' --tlsv1.2 -sSf https://sh.rustup.rs | sh` and ensure `cargo` is in PATH.

Upgrade

Version history

1.0.0latest on npm

Audit

Dependencies

claude-code-clioptionalPrimary supported AI coding harness for running migration commands

opencodeoptionalAlternative AI coding harness; has limited hook support

Agent activity

9 hits · last 30 days

node

OpenAI (training)

Resources

packagescion-toolkit ↗