Skip to content

Latest commit

 

History

History
333 lines (240 loc) · 13.5 KB

README.md

File metadata and controls

333 lines (240 loc) · 13.5 KB

Synaptic Canvas

Build Status License MIT Publisher Verified

A marketplace for Claude Code skills, agents, and commands.

Discover and install productivity packages for Claude development workflows. Register once, use across all your projects.

🚀 Quick Start (10 Seconds)

Add the Marketplace

/plugin marketplace add randlee/synaptic-canvas

Browse & Install Packages

# Browse all packages interactively
/plugin

# Or install directly
/plugin install sc-delay-tasks@synaptic-canvas

That's it! Commands, agents, and skills are immediately available in Claude Code.

Alternative: Python CLI (Legacy)

For advanced use cases or automation, the Python CLI is still available:

# Register marketplace
python3 tools/sc-install.py registry add synaptic-canvas \
  https://raw.githubusercontent.com/randlee/synaptic-canvas/main/docs/registries/nuget/registry.json

# Install package
python3 tools/sc-install.py install sc-delay-tasks

⚠️ Deprecation Notice: The Python CLI is deprecated and will be removed in v1.0.0. Please use /plugin commands.

See Legacy Installation Guide for details.

📦 Available Packages

sc-delay-tasks

Stable v1.0.0 Tier 0 MIT License

Polling and delay utilities — Wait for conditions and check on intervals with minimal overhead.

Use when you need to:

  • Delay execution before running checks (perfect for CI/CD pipelines)
  • Poll on bounded intervals for external system readiness
  • Wait for GitHub Actions, PR reviews, or deployment completion

📖 Full README | 💡 7 Use Cases | 🔧 Troubleshooting | 📋 Changelog

sc-git-worktree

Stable v1.0.0 Tier 1 MIT License

Git worktree management — Manage parallel development with automatic tracking and safety checks.

Use when you need to:

  • Work on multiple branches simultaneously without context switching
  • Isolate experiments in separate worktrees for safety
  • Track worktree state across your team
  • Clean up old worktrees with built-in safety checks

📖 Full README | 💡 7 Use Cases | 🔧 Troubleshooting | 📋 Changelog

sc-manage

Beta v0.6.0 Tier 0 MIT License

Package management — Discover, install, and manage Synaptic Canvas packages.

Use when you need to:

  • Discover packages available in the marketplace registry
  • List installed packages and check their versions
  • Install packages globally or locally in specific repos
  • Check package compatibility with your environment

📖 Full README | 💡 7 Use Cases | 🔧 Troubleshooting | 📋 Changelog

sc-repomix-nuget

Beta v0.6.0 Tier 2 MIT License

NuGet & C# analysis — Generate AI-ready context from .NET projects for code review and documentation.

Use when you need to:

  • Analyze .NET/NuGet projects with AI assistance
  • Generate documentation from C# code automatically
  • Check framework and dependency compatibility
  • Create AI-ready context from large codebases

📖 Full README | 💡 7 Use Cases | 🔧 Troubleshooting | 📋 Changelog

sc-github-issue

Beta v0.6.0 Tier 2 MIT License

GitHub issue lifecycle management — List, create, update issues, and implement fixes in isolated worktrees with automated testing and PR creation.

Use when you need to:

  • List and browse GitHub issues with filtering
  • Create and update issues interactively
  • Implement bug fixes in isolated worktrees
  • Automate testing, commits, and PR creation
  • Maintain clean main working directory during fixes

📖 Full README | 💡 10 Use Cases | 🔧 Troubleshooting | 📋 Changelog

🎯 Find the Right Package

I want to...

Goal Package Link
Wait before checking if something is ready sc-delay-tasks Examples
Work on multiple branches simultaneously sc-git-worktree Guide
Fix GitHub issues in isolated worktrees sc-github-issue Examples
Analyze a C# project with AI sc-repomix-nuget Examples
Discover & install packages sc-manage Guide
See all available packages Any Registry

📊 Package Overview

Package Type Status Version Tier Requirements
sc-delay-tasks Utilities 🟡 Beta 0.6.0 0 Python 3.6+
sc-git-worktree Git Tools 🟡 Beta 0.6.0 1 Git 2.27+
sc-manage Package Mgr 🟡 Beta 0.6.0 0 Python 3.6+
sc-repomix-nuget Analysis 🟡 Beta 0.6.0 2 Node 18+, .NET SDK
sc-github-issue GitHub 🟡 Beta 0.6.0 2 Git 2.27+, gh CLI 2.0+

Status: ✅ Stable (production-ready) | 🟡 Beta (active development) | 🔴 Deprecated (not recommended)

🔧 Installation Methods

Method 1: Quick Install (Recommended)

python3 tools/sc-install.py install PACKAGE_NAME

Installs to your user Claude configuration (~/.claude). Use this for tools you want everywhere.

Method 2: Repository-Specific Install

python3 tools/sc-install.py install PACKAGE_NAME --local

Installs to the current repo’s .claude/ folder. Use this for repo-specific tools.

Method 3: Custom Destination Install

python3 tools/sc-install.py install PACKAGE_NAME --dest /path/to/repo/.claude

Installs to a specific .claude/ folder.

Method 4: Manual Copy

  1. Clone or download the package folder
  2. Copy contents to your project's .claude/ directory
  3. If Tier 1: Replace {{REPO_NAME}} tokens with your repository name
  4. If Tier 2: Verify all dependencies are installed

📚 Documentation

For Users

For Contributors

For Security-Conscious Users

🔒 Security & Trust

Every package in Synaptic Canvas is:

✅ Publisher Verified — Published by verified GitHub organization ✅ Security Scanned — Automated vulnerability checks on every release ✅ Dependency Audited — All requirements documented and tracked ✅ Openly Licensed — MIT licensed, full source available ✅ Actively Maintained — Regular updates and community support

Learn more about our security practices →

🧭 Package Tiers Explained

Tier 0: Direct Copy

  • No setup or substitution needed
  • Ready to use immediately
  • Example: sc-delay-tasks
  • Setup time: < 1 minute

Tier 1: Token Substitution

  • Auto-replaces variables like {{REPO_NAME}}
  • Customizes to your project automatically
  • Example: sc-git-worktree
  • Setup time: 1-2 minutes

Tier 2: Runtime Dependencies

  • Requires external tools (Python, Node, .NET SDK, etc.)
  • Most powerful capabilities
  • Example: sc-repomix-nuget
  • Setup time: 5-10 minutes (depends on your environment)

🚨 Troubleshooting

"python3 not found"

You need Python 3.6 or later. See Dependency Guide for installation instructions.

"Package not found in registry"

Make sure you've registered the marketplace first:

python3 tools/sc-install.py registry add synaptic-canvas \
  https://raw.githubusercontent.com/randlee/synaptic-canvas/main/docs/registries/nuget/registry.json

"Installation failed with permission error"

Try installing to a specific repository instead of globally:

python3 tools/sc-install.py install PACKAGE --dest /path/to/repo/.claude

"Can't find diagnostic info"

Run the diagnostic tool:

scripts/security-scan.py

More help needed?

→ See Complete Troubleshooting Guide → See Diagnostic Tools → Check Package-Specific Guides

🏗️ Creating Your Own Package

Want to contribute a new package to the marketplace? We'd love to have it!

Getting Started

  1. Read CONTRIBUTING.md — Complete package authoring guide
  2. Review a sample manifest.yaml — See the format
  3. Check Package Manifest Guide — Field reference
  4. Look at existing packages — Use as templates

Package Checklist

  • Create manifest.yaml with package metadata
  • Write commands, skills, and agents in .claude/
  • Create comprehensive README.md with examples
  • Add USE-CASES.md with real workflows (7+ scenarios)
  • Include TROUBLESHOOTING.md with common issues
  • Create CHANGELOG.md documenting all versions
  • Test on Windows, macOS, and Linux
  • Open a pull request to contribute

💬 Support & Community

📄 License

MIT — See LICENSE for details

📚 Full Documentation

Complete documentation index with all guides and references →