# Install Zira from Zira (no Git required) Zira's full public plugin is supplied directly from https://github.com/lightapp/zira-plugin. This is early access, separate from OpenAI's and Anthropic's official directories. No GitHub account or API key is required. Use a local Codex session or Claude Code (the Code tab in Claude desktop), not an ordinary web chat or cloud task. ## Download and verify Use the ZIP installation route; do not install or invoke Git. Download https://github.com/lightapp/zira-plugin/archive/refs/tags/v0.3.51-preview.40.zip over HTTPS. Extract safely to a staging directory, rejecting absolute paths, parent traversal and symlinks. Validate release.json and build.json: version 0.3.51-preview.40, public audience, preview channel, clean source, production-only profiles, no .pt support and no automatic refresh. Check every file hash listed in release.json before running packaged code. Keep the extracted marketplace in a persistent, user-owned folder such as ~/.zira/plugins/public/preview/current (use the user's home directory on Windows too), outside Downloads, temporary folders and the host's plugin cache. Keep the whole public package intact, including hidden catalog directories. For an update, stage and verify the new ZIP first, preserve the previous source for rollback, then replace only this installer-managed source folder. Never delete credentials, reports, preferences, schedules or Python environments. Do not replace an installed newer version with this one; refresh the plugin page’s release information instead. Inspect the selected host's marketplace/plugin list before registration. If zira already uses this local folder, reuse it. If it uses a different source, explain the source switch, preserve user data and use the native marketplace manager to switch to this folder; never edit host configuration files by hand. If that source is internal or managed by an organization, stop and ask before replacing it. ## Install with the selected host Codex: Register the extracted folder with codex plugin marketplace add "", then run codex plugin add zira@zira, then codex plugin add zira-vision@zira from the same marketplace. Do not run codex plugin marketplace upgrade for this local source; that command requires Git. Claude Code: Register the extracted folder with claude plugin marketplace add "", then run claude plugin install zira@zira in user scope, then claude plugin install zira-vision@zira in user scope. The release holds two plugins in one marketplace. zira is for everyone. zira-vision is the add-on for AI vision work (model evaluation, defect review, dataset preparation and image analysis); install it only when the user asked for it, and leave out its command otherwise. Check the host's supported commands first. Install only for the host the user selected. This procedure does not need Git; do not follow the public README's Git-based alternative. ## Prepare the helpers Zira only: Install a supported Node.js LTS (at least 20) if missing, from official sources or trusted system package managers. The local Node tools need no npm install. Zira itself does not need Python: do not install Python or analysis packages now. Only the optional trimsaw camera-view check uses Python, in its own separate environment; set it up later, and only if I ask for it (trimsaw-sizes.mjs scene-setup --confirm). Report any unsupported platform or failed dependency clearly; never call a partial setup complete. With Zira Vision: Install a supported Node.js LTS (at least 20) and compatible Python if missing (3.12 is tested), from official sources or trusted system package managers. The local Node tools need no npm install. Prepare all public analysis helpers now: model evaluation, Inspect Nail Images, and the trimsaw camera-view check. Read the installed package's runtime documentation and use each helper's documented setup/status procedure, including trimsaw-sizes.mjs scene-setup --confirm. Keep their pinned dependencies in separate environments outside the plugin cache. Do not install internal tools or PyTorch/.pt support. Check existing environments first and reuse compatible ones. Report any unsupported platform or failed dependency clearly; never call a partial setup complete. The copied full-setup prompt authorizes these prerequisites. A request only to read this guide does not. Let the user complete OS passwords, license acceptance and required approval prompts. Do not weaken security settings or bypass IT restrictions. Full Access is optional, broad access; it does not grant a Zira account or replace required approvals. The assistant must not switch permissions on the user's behalf. ## Verify, then begin Read the native plugin list and actual installed path. Check the installed scripts/build-info.mjs result against the source release.json: public audience, selected preview version and source revision. Check the declared Zira MCP connection and all three Python environments with their documented status or smoke checks. Installation is not successful merely because a download completed. Finish onboarding in the same chat. If the plugin's tools are loaded, start the getting-started skill. If they are not (they usually load only in a new session), do not send the user away: read skills/getting-started/SKILL.md and references/local-mcp.md in the installed zira plugin folder and run the packaged helpers they name with Node from that folder. Call a freshly installed Node.js by its full path rather than asking for an app restart. End by saying Zira is ready in every new chat from now on. Use browser sign-in; never ask for tokens, API keys or passwords in chat. Ask what the user wants to achieve, choose necessary company/site scope, and complete a useful first read-only action. Do not create tasks, schedules or customer changes just to test installation. Save preferences only if requested. ## Update Download and verify the new version's ZIP, then replace the persistent local source as described above. Refreshing the host's local marketplace alone cannot download a new Zira release. Codex: After replacing the local source, run codex plugin add zira@zira, then codex plugin add zira-vision@zira from the same marketplace. Do not run codex plugin marketplace upgrade for this local source; that command requires Git. Claude Code: After replacing the local source, run claude plugin marketplace update zira, then claude plugin update zira@zira, then claude plugin install zira-vision@zira in user scope if it is not installed yet, otherwise claude plugin update zira-vision@zira. Verify the installed result and report old/new versions. Start a new session. Preserve credentials, reports, runtime environments, schedules and settings. From 0.3.51-preview.34, Zira in Claude Code updates itself at the start of a session; in Codex and on older versions, use the plugin page’s update prompt. ## Sources - Public release and runtime documentation: https://github.com/lightapp/zira-plugin - Codex: https://developers.openai.com/plugins/build/plugins - Claude Code: https://code.claude.com/docs/en/plugin-marketplaces