{"id":47711283,"url":"https://github.com/vulca-org/vulca-plugin","last_synced_at":"2026-05-01T23:04:11.076Z","repository":{"id":346240639,"uuid":"1189053291","full_name":"vulca-org/vulca-plugin","owner":"vulca-org","description":"VULCA plugin for Claude Code \u0026 Cursor — 21 MCP tools + skills for AI cultural art creation \u0026 evaluation","archived":false,"fork":false,"pushed_at":"2026-05-01T15:32:19.000Z","size":120,"stargazers_count":1,"open_issues_count":1,"forks_count":0,"subscribers_count":0,"default_branch":"main","last_synced_at":"2026-05-01T17:26:27.599Z","etag":null,"topics":["ai-art","claude-code","cultural-evaluation","mcp","plugin","vulca"],"latest_commit_sha":null,"homepage":"https://pypi.org/project/vulca/","language":null,"has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"other","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/vulca-org.png","metadata":{"files":{"readme":"README.md","changelog":"CHANGELOG.md","contributing":null,"funding":null,"license":"LICENSE","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":null,"dco":null,"cla":null}},"created_at":"2026-03-22T23:28:36.000Z","updated_at":"2026-05-01T13:06:19.000Z","dependencies_parsed_at":null,"dependency_job_id":null,"html_url":"https://github.com/vulca-org/vulca-plugin","commit_stats":null,"previous_names":["vulca-org/vulca-plugin"],"tags_count":10,"template":false,"template_full_name":null,"purl":"pkg:github/vulca-org/vulca-plugin","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/vulca-org%2Fvulca-plugin","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/vulca-org%2Fvulca-plugin/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/vulca-org%2Fvulca-plugin/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/vulca-org%2Fvulca-plugin/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/vulca-org","download_url":"https://codeload.github.com/vulca-org/vulca-plugin/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/vulca-org%2Fvulca-plugin/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":32515839,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-04-30T13:12:12.517Z","status":"online","status_checked_at":"2026-05-01T02:00:05.856Z","response_time":64,"last_error":null,"robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":true,"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":["ai-art","claude-code","cultural-evaluation","mcp","plugin","vulca"],"created_at":"2026-04-02T18:32:47.543Z","updated_at":"2026-05-01T23:04:11.067Z","avatar_url":"https://github.com/vulca-org.png","language":null,"funding_links":[],"categories":[],"sub_categories":[],"readme":"# Vulca Agent Plugin\n\n\u003cp align=\"center\"\u003e\n  \u003cimg src=\"assets/vulca-logo.svg\" alt=\"Vulca logo\" width=\"240\"\u003e\n\u003c/p\u003e\n\nVulca is an agent-native visual control layer for Claude Code, Gemini CLI, and Codex Desktop/CLI. It turns fuzzy creative intent into reviewable direction cards, structured prompts, semantic layers, provider-routed image work, and L1-L5 cultural evaluation.\n\nThis plugin tracks the Vulca SDK v0.23.0 package shape.\n\nRepository links:\n\n- SDK / CLI / MCP server: [vulca-org/vulca](https://github.com/vulca-org/vulca)\n- Plugin package: [vulca-org/vulca-plugin](https://github.com/vulca-org/vulca-plugin)\n- Web platform / demo: [vulcaart.art](https://vulcaart.art)\n- Directory logo: [`assets/vulca-icon.svg`](assets/vulca-icon.svg)\n\n## Claude Code Install\n\n```bash\npip install \"vulca[mcp] @ git+https://github.com/vulca-org/vulca.git@v0.23.0\"\nclaude plugin install vulca-org/vulca-plugin\n```\n\nFor local development, you can validate this repository directly:\n\n```bash\nclaude plugin validate .\nclaude --plugin-dir .\n```\n\nThe bundled MCP configuration starts `vulca-mcp` from your `PATH`. Configure provider API keys only when you explicitly want real-provider generation, editing, or evaluation. Mock/no-cost workflows work without external provider keys.\n\n## Gemini CLI Install\n\nGemini CLI can install this repository as an extension. The extension bundles persistent `GEMINI.md` context and starts the same local Vulca MCP server.\n\n```bash\npip install \"vulca[mcp] @ git+https://github.com/vulca-org/vulca.git@v0.23.0\"\ngemini extensions install vulca-org/vulca-plugin\n```\n\nFor local development:\n\n```bash\ngemini extensions validate .\ngemini extensions link .\n```\n\nGemini provider-backed workflows require your own Gemini authentication, for example `GEMINI_API_KEY`, and remain explicit opt-in.\n\n## Codex Desktop / CLI Install\n\nCodex can install this repository as a plugin marketplace. The plugin bundles the same skills and local `vulca-mcp` server configuration for Codex Desktop and Codex CLI.\n\n```bash\npip install \"vulca[mcp] @ git+https://github.com/vulca-org/vulca.git@v0.23.0\"\ncodex marketplace add https://github.com/vulca-org/vulca-plugin\n```\n\nFor local development:\n\n```bash\ncodex marketplace add .\n```\n\nThis is a Codex-compatible marketplace package. OpenAI's official public Codex plugin directory submission flow is not documented as a public form at this time.\n\n## Skills\n\n| Skill | Purpose |\n| --- | --- |\n| `/decompose` | Decompose an image into semantic transparent layers. |\n| `/visual-discovery` | Turn fuzzy visual intent into taste profile, direction cards, and prompt artifacts. |\n| `/visual-brainstorm` | Convert a selected direction into a reviewable proposal. |\n| `/visual-spec` | Resolve provider, prompt, threshold, and cost decisions into `design.md`. |\n| `/visual-plan` | Execute planned generation/evaluation iterations from `design.md`. |\n| `/evaluate` | Evaluate an existing image against Vulca's cultural and visual rubric. |\n| `/using-vulca-skills` | Meta-skill that guides when Claude should invoke the Vulca workflow skills. |\n\n## Positioning\n\nVulca does not host a foundation image model and does not promise one-click image quality. It coordinates provider-backed workflows through auditable artifacts:\n\n```text\ndiscovery.md\ntaste_profile.json\ndirection_cards.json\nproposal.md\ndesign.md\nplan.md\nmanifest.json\nevaluation.json\n```\n\nRedraw and inpaint tools are available as advanced MCP workflows in the SDK. They should not be marketed as polished top-level user skills until target-aware redraw evidence has been reviewed on real images.\n\n## Privacy\n\nVulca works with local image files and optional external image providers. When you opt into a real provider, prompts, images, and provider metadata may leave your machine depending on that provider's configuration and terms. Keep generation, editing, and VLM-backed evaluation explicit.\n\nSee [PRIVACY.md](PRIVACY.md) for submission-ready privacy notes and [SUBMISSION.md](SUBMISSION.md) for marketplace copy and validation commands. See [GEMINI.md](GEMINI.md), [gemini-extension.json](gemini-extension.json), and [.codex-plugin/plugin.json](.codex-plugin/plugin.json) for Gemini CLI and Codex packaging.\n\n## License\n\nApache-2.0\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fvulca-org%2Fvulca-plugin","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fvulca-org%2Fvulca-plugin","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fvulca-org%2Fvulca-plugin/lists"}