{"id":16455876,"url":"https://github.com/roger-luo/ion","last_synced_at":"2026-05-07T03:02:04.464Z","repository":{"id":65501491,"uuid":"593508260","full_name":"Roger-luo/Ion","owner":"Roger-luo","description":"Ion - a CLI toolbox for agentic developers","archived":false,"fork":false,"pushed_at":"2026-05-07T01:09:18.000Z","size":5103,"stargazers_count":74,"open_issues_count":2,"forks_count":2,"subscribers_count":1,"default_branch":"main","last_synced_at":"2026-05-07T02:36:54.698Z","etag":null,"topics":["agent","cli","package-manager","skills","tools"],"latest_commit_sha":null,"homepage":"http://ion.rogerluo.dev/","language":"Rust","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":null,"status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/Roger-luo.png","metadata":{"files":{"readme":"README.md","changelog":"CHANGELOG.md","contributing":null,"funding":null,"license":null,"code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null,"notice":null,"maintainers":null,"copyright":null,"agents":"AGENTS.md","dco":null,"cla":null}},"created_at":"2023-01-26T07:06:15.000Z","updated_at":"2026-05-07T01:07:38.000Z","dependencies_parsed_at":"2023-02-15T00:46:39.463Z","dependency_job_id":null,"html_url":"https://github.com/Roger-luo/Ion","commit_stats":null,"previous_names":[],"tags_count":74,"template":false,"template_full_name":null,"purl":"pkg:github/Roger-luo/Ion","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Roger-luo%2FIon","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Roger-luo%2FIon/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Roger-luo%2FIon/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Roger-luo%2FIon/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/Roger-luo","download_url":"https://codeload.github.com/Roger-luo/Ion/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Roger-luo%2FIon/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":32720776,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-05-07T02:14:30.463Z","status":"ssl_error","status_checked_at":"2026-05-07T02:14:29.405Z","response_time":62,"last_error":"SSL_connect returned=1 errno=0 peeraddr=140.82.121.6:443 state=error: unexpected eof while reading","robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":false,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["agent","cli","package-manager","skills","tools"],"created_at":"2024-10-11T10:24:01.015Z","updated_at":"2026-05-07T03:02:04.431Z","avatar_url":"https://github.com/Roger-luo.png","language":"Rust","funding_links":[],"categories":[],"sub_categories":[],"readme":"# Ion\n\nAgent skill manager for AI coding tools (Claude, Cursor, Windsurf, etc.).\n\nIon manages installation, validation, and organization of **skills** — reusable prompts and instructions that enhance AI agent capabilities.\n\n## Why Ion\n\nThe agent skills ecosystem has grown rapidly. Tools like Vercel's [`npx skills`](https://github.com/vercel-labs/skills) pioneered the idea of an \"npm for agent skills.\" Ion takes a different approach — it's a standalone binary with no runtime dependency, built for reproducible installs and agent-driven workflows.\n\n| | Ion | `npx skills` |\n|---|---|---|\n| **Runtime** | Single binary (Rust) | Node.js / npx |\n| **Manifest \u0026 lockfile** | `Ion.toml` + `Ion.lock` with checksums | No lockfile |\n| **Reproducibility** | Pinned revisions, lockfile checksums | Latest-only |\n| **Validation** | Built-in security, structure, and markdown checks | None |\n| **Agent interface** | `--json` mode on every command with structured envelope | None |\n| **Local skills** | First-class `type = \"local\"`, eject from remote | Symlink/copy from path |\n| **Binary skills** | Download, checksum, and run compiled tools via `ion run` | Not supported |\n| **Self-update** | `ion self update` with signed GitHub Release binaries | npm/npx update |\n\nIon is designed for teams that want their skill dependencies to be **versioned, validated, and reproducible** — the same properties you expect from a package manager, applied to agent instructions.\n\n## Installation\n\n```bash\ncurl -fsSL https://raw.githubusercontent.com/Roger-luo/Ion/main/install.sh | sh\n```\n\nTo install a specific version:\n\n```bash\ncurl -fsSL https://raw.githubusercontent.com/Roger-luo/Ion/main/install.sh | sh -s -- 0.1.2\n```\n\nOr install from source:\n\n```bash\ncargo install --git https://github.com/Roger-luo/Ion\n```\n\n## Quick Start\n\n```bash\n# Initialize a project with a target\nion project init --target claude\n\n# Add a skill\nion add obra/superpowers/brainstorming\n\n# Install all skills from Ion.toml\nion add\n\n# Search for skills\nion search \"code review\"\n\n# Create a new local skill\nion skill new\n\n# List installed skills\nion skill list\n```\n\n## Commands\n\n| Command | Description |\n|---------|-------------|\n| `ion add [source]` | Add a skill, or install all from Ion.toml |\n| `ion remove \u003cname\u003e` | Remove a skill |\n| `ion search \u003cquery\u003e` | Search registries and GitHub |\n| `ion update [name]` | Update skills to latest versions |\n| `ion run \u003cname\u003e` | Run a binary skill |\n| `ion skill new` | Create a new skill |\n| `ion skill eject \u003cname\u003e` | Eject a remote skill into an editable local copy |\n| `ion skill validate` | Validate skill definitions |\n| `ion skill list` | List installed skills |\n| `ion skill info \u003cname\u003e` | Show skill details |\n| `ion skill link \u003cpath\u003e` | Link a local skill directory |\n| `ion project init` | Initialize Ion.toml with targets |\n| `ion project migrate` | Migrate from legacy formats |\n| `ion cache gc` | Clean up stale cached repos |\n| `ion config` | View and set configuration |\n\n## JSON Mode for Agents\n\nAll commands support `ion --json \u003ccommand\u003e` for structured, non-interactive output. This enables AI agents and CI scripts to operate Ion programmatically.\n\n```bash\n# Structured search results\nion --json search \"testing\"\n\n# Two-stage commands: preview first, then execute\nion --json remove my-skill        # returns what would be removed (exit 2)\nion --json remove my-skill --yes  # executes the removal (exit 0)\n```\n\nSee [SKILL.md](SKILL.md) for the full agent interface reference.\n\n## License\n\nMIT\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Froger-luo%2Fion","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Froger-luo%2Fion","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Froger-luo%2Fion/lists"}