{
  "markdown": "# Vulca Agent Plugin\n\n<p align=\"center\">\n  <img src=\"assets/vulca-logo.svg\" alt=\"Vulca logo\" width=\"240\">\n</p>\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.1 package shape.\n\nRepository links:\n\n- SDK / CLI / MCP server: [vulca-org/vulca-visual-control-sdk](https://github.com/vulca-org/vulca-visual-control-sdk)\n- Plugin package: [vulca-org/vulca-visual-agent-plugin](https://github.com/vulca-org/vulca-visual-agent-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]==0.23.1\"\nclaude plugin install vulca-org/vulca-visual-agent-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]==0.23.1\"\ngemini extensions install vulca-org/vulca-visual-agent-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]==0.23.1\"\ncodex plugin marketplace add vulca-org/vulca-visual-agent-plugin\ncodex plugin add vulca --marketplace vulca-visual-agent-plugin\n```\n\nFor local development:\n\n```bash\ncodex plugin marketplace add .\ncodex plugin add vulca --marketplace vulca-visual-agent-plugin\n```\n\nThis is a Codex-compatible marketplace package. Public submissions use the [OpenAI plugin submission portal](https://platform.openai.com/plugins) and require an eligible organization role plus a verified developer or business identity.\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",
  "bytes": 4390,
  "sha": "caa77880a56632a666d12efae505c03bf038acfec69139e4ab6bda8c5389a0ea",
  "repo_slug": "vulca-org/vulca-plugin",
  "fonte": "repo",
  "truncated": false,
  "api": "https://agentalog.com/api/listings/plg_vulca_org_vulca_plugin_vulca_688d3d64/readme"
}