Skip to content

randlee/synaptic-canvas

Folders and files

NameName
Last commit message
Last commit date

Latest commit

Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 

Repository files navigation

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

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


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


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


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


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 β†’

About

The neural network of developer creativity

Resources

License

Contributing

Security policy

Stars

Watchers

Forks

Packages

No packages published

Contributors 2

  •  
  •