# Zira in Claude and Codex (Beta)

Source: https://help.zira.us/docs/ai-assistance/zira-plugin
Summary: Install the Zira plugin and run Zira from your AI chat. Ask about your production data, check your device fleet, build and schedule reports, manage tasks and set up devices, all in plain words.
Updated: 2026-11-19

With the **Zira plugin**, your AI chat becomes a control room for Zira. Ask **Claude** or **Codex**
anything about your plant and it answers from your live Zira data. It can show you how a machine
performed last week, which devices need attention, or what tasks are open. And when you want
something done, such as a report, a task or a new device set up, just say so.

You stay in charge: the plugin signs in as you, sees only what you can see in Zira, and asks
before it creates or changes anything.

**Early access.** Install Zira directly from [Zira](/ai-plugins). It comes as two plugins:
**Zira** for everyday questions, reports, dashboards and tasks, and the **Zira Vision** add-on for
people who work on models and image analysis. Most people need only Zira.
This is separate from OpenAI's and Anthropic's official directories. You need your own
Zira account to work with company data; the public download does not require a GitHub account.

## What you can ask

| Ask about | For example |
| --- | --- |
| **Your production data** | *"Show me the performance of Trimsaw 1 over the past week."* |
| **Reports** | *"Send me a weekly report for my saws every Monday at 7:00."* |
| **Vision model accuracy** | *"How accurate is the newest model on Bandsaw 1?"* |
| **Device health** | *"Show me the health of my device fleet."* |
| **Device status** | *"Which cameras have a low battery?"* |
| **Tasks** | *"Show my open tasks"* or *"Create a task for Bandsaw 3."* |
| **Sites, machines and dashboards** | *"What data sources do we have at this site?"* |
| **Dashboards, forms and data sources** | *"Start a dashboard comparing my three bandsaws."* |
| **Copies for another site** | *"Copy the Band Saw 1 dashboard to South Charleston."* |
| **AI reports by email** | *"Email me a summary of the KPI Overview dashboard every weekday."* |
| **Vision devices, datasets and models** | *"Help me set up the new camera on Bandsaw 2."* |
| **Zira itself** | *"How do I add a widget to a dashboard?"* |

## Install Zira with one prompt

Open [AI plugins](/ai-plugins), choose **Codex** or **Claude Code**, tick **Zira Vision** only if
you need it, and copy the setup prompt.
Paste it into a **Local** chat in that app. In the Claude desktop app, use the **Code** tab.
Your assistant checks your computer, installs the plugin and missing helper programs, and verifies
that Zira can start. You do not need to type terminal commands.

Your assistant installs Zira and the **Node.js** helper it needs. Zira Vision also needs
**Python**, which your assistant sets up when you choose it. You can add Zira Vision later from
the same page. No Git required.

Normal permission prompts work. Codex's optional **Full Access** setting can reduce interruptions,
but gives the assistant broad access to your computer. If you choose it for a dedicated setup chat,
return to your usual setting afterwards. Your assistant cannot bypass your computer's approval
prompts or your organization's IT policies. Never type a password into the chat.

When Zira is installed, the assistant continues in the same chat with **Getting started**. You do
not need to open a new chat or paste anything else. After that, Zira is ready in every new chat.

Sign in to your Zira account in the browser window that opens. Tell the assistant what matters to
you; it chooses a relevant first action and asks for a site only if needed. The first result might
be your open tasks, a camera check, or help understanding an existing dashboard. Saving preferences
is optional. Installation does not create tasks, activate schedules or change devices.

## Update or download

The [AI plugins page](/ai-plugins#updates) has an **Update** prompt and a ZIP download of a specific
public release. Updating preserves your settings, sign-in, reports and schedules. Start a new local
chat afterwards. In Claude Code, Zira updates itself. A new version installs in the background when you start a session and is ready in the next one. Say "stop updating Zira automatically" to switch that off. In Codex, say "update Zira" when Zira tells you a new version is available. A ZIP download alone does not install Zira or its helper programs.

The public plugin includes local reporting, image/model tools and optional Claude Code panels.
Internal engineering and device-control tools are excluded. Public model evaluation supports
`.tflite`; some actions depend on the access and data available to your Zira account.

## Where to use Zira

Zira runs on your computer, so it works only in these places:

- **Claude desktop app:** the **Code** tab, next to Chat and Cowork. Start a new session, pick any
  folder (Documents is fine) and keep it on this computer (**Local**). Claude Code in a terminal
  works too.
- **Codex app:** a new thread that runs on this computer (**Local**), not a Cloud task.

**Come back to the same place every time you use Zira.** Claude's **Chat** and **Cowork** tabs,
Claude in a web browser and ChatGPT can't see your Zira data. There, the assistant may try to click
through Zira in a web browser, which is slow. Zira also appears only in sessions started after
you install or update it, so start a new session if it is missing.

**No technical setup on your part.** If your computer needs a free helper program called
**Node.js**, the assistant offers to set it up for you: you click through a standard installer, and
on a work computer it gives you a short note to send to IT. If something isn't working, say
**"set up Zira"** and the assistant checks what's missing and fixes it with you.

## See everything Zira can do: type /zira

Type `/zira` in the chat box. A list opens with every Zira action. Pick one to start it, or keep
typing to filter the list.

In Claude, the actions appear as short commands such as **zira:show-tasks** and
**zira:health-report**. Point at one to see what it does.

![The Zira actions listed after typing /zira in Claude, with a description of Get Started.](/docs/ai/zira-plugin/03-zira-commands.png)

In Codex, the same actions appear by name, such as **Get Started with Zira**, **Show My Open
Tasks** and **Health Report**, each with a one-line description.

![The Zira actions listed after typing /zira in Codex.](/docs/ai/zira-plugin/03-codex-zira-commands.png)

You never have to use the list: asking in your own words works just as well. The list is a quick
way to discover what is possible.

## Ask about your production data

Ask about a machine the way you would ask a colleague:

> *"Show me the performance of Trimsaw 1 over the past week."*

Zira finds Trimsaw 1 and its downtime records, downloads the week's readings and answers in the
chat: the units it made, its yield, its best and slowest days, and why it stopped. At the same
time it opens an interactive report next to the chat:

- A **short written summary** of what happened and anything unusual.
- **Key numbers**, such as units, yield, working share and unplanned stop minutes.
- **Charts** by hour, day or shift.
- Controls to change the **dates**, **interval** and **machines**. Pick earlier dates and click
  **Load** to bring in more weeks from Zira.

![Zira's answer about Trimsaw 1 in the chat, with the interactive report beside it: a written summary and the week's key numbers.](/docs/ai/zira-plugin/04-trimsaw-answer.png)

Keep the conversation going to dig deeper:

- *"Add a chart by shift."*
- *"Compare it with Bandsaw 1, 2 and 3."*
- *"Now show me September."*

![A follow-up report comparing pallets per hour on Bandsaw 1, 2 and 3 alongside Trimsaw 1.](/docs/ai/zira-plugin/01-readings-report.png)

## Save, schedule and share a report

Once a report looks right, keep it working for you:

| Say | What happens |
| --- | --- |
| *"Save this report as Trimsaw weekly."* | The report is saved, ready to rerun with fresh data any time. |
| *"Run Trimsaw weekly."* | Zira downloads the latest readings and rebuilds the report with a new summary. |
| *"Run Trimsaw weekly every Monday at 7:00."* | Your assistant schedules it, and a fresh report is ready every week. |
| *"Share this report with my team."* | You choose how: send the report file, or publish a private link and pick who can open it. |
| *"Open last week's Trimsaw report."* | Zira finds the saved report instead of building it again. |

Every chart and table also has **CSV** and **Open in Sheets**, so you can take the numbers straight
into a spreadsheet.

Each answer that builds a report ends with an **Open the report** link to its saved copy. The link
keeps working later, even after the chat is closed.

### Set up a recurring report in a few questions

> *"Send me a weekly report for my saws."*

Pick the machines and Zira recognizes each one. Trimsaws, bandsaws, Pallet QA cameras and forms
each get a ready-made report with the numbers that matter for them. Choose what each report covers
(a day, a week or four weeks), the day and the time. Every report compares its period with the one
before:

- **Key numbers**, such as output, yield, fail rate and running time, each marked better or worse.
- **Days worth a look**, such as a high fail rate or long stops with no reason entered.
- **Machines that went quiet**, and since when.

You can add or remove parts of the report, change what counts as a bad day, or ask for a
different schedule at any time. In Claude, Zira can also keep a private page updated with the
latest report, so you open the same link every week.

![A weekly report for four saws: each number compared with the week before, the status of each machine, and units per day.](/docs/ai/zira-plugin/07-scheduled-readings-report.png)

Reports are saved on your computer. Nothing is shared until you decide to share it.

## Evaluate a Vision model

> *"How accurate is the newest model on Bandsaw 1?"*

Before you put a Vision model to work, find out how well it really does. Zira finds the camera,
lets you pick the dataset, version and model, downloads them, and runs the model on your computer.
It is fast, and nothing is uploaded or changed in Zira. You can also use a model or dataset file
you already have on your computer.

You get an evaluation report that opens in your browser:

- **Headline scores**: **precision** (of everything the model found, how much was right),
  **recall** (of everything that was there, how much it found), and an overall score.
- **A score for every class**, such as each defect or nail type, so you see where the model is
  strong and where it struggles.
- **Every image, marked up**: correct finds in green, misses in red and extra finds in orange, with
  the class and confidence. The images it gets wrong come first, and **With errors**, **Misses**
  and **Extras** narrow the list.
- **Live tuning**: change a class's confidence threshold in the report and the scores and images
  update straight away. The page address keeps your settings, so reopening it shows the same
  view.

![A model evaluation: precision, recall and F1, a score for each class with confidence and match sliders, and validation images with correct, missed and extra finds marked.](/docs/ai/zira-plugin/05-model-evaluation.png)

Zira also sums up the results in the chat and suggests what to try next: another split, all
images, or another model to compare.

- *"Now try the previous model on the same dataset."*
- *"Run it on all images, not only the validation set."*

## Check the health of your device fleet

> *"Show me the health of my device fleet."*

Zira checks every trimsaw, bandsaw and pallet QA device at your site and opens a health dashboard.
The devices that need attention come first: a camera that stopped sending data, a device that is
too hot, a low battery. Devices that have been quiet for a long time are listed separately, so
they do not bury today's problems.

![A health dashboard: counts by status, then each device with its last signal, power, network and camera status, with the devices that are down listed first.](/docs/ai/zira-plugin/07-health-report.png)

From there:

- *"Create tasks for the devices that need attention."* Zira prepares one task for each problem
  and shows you the list before anything is created.
- *"Why did Bandsaw 2 stop sending data?"* Zira looks into a finding and tells you what it
  found and what needs a person on site.
- *"Share this dashboard with my maintenance team."* Publish it as a link and choose who can open
  it.
- *"Run this check every working day at 7:00 and only tell me when something changes."*

To check every site each morning, say *"Check my Ohio sites' devices every morning."* Zira asks a
few questions and sets it up. When nothing changed, the daily message is one line.

### Keep an eye on your cameras while you work

In Claude, type `/zira:device-status-panel` to open the **Device Status** panel for your saved site.
It has one row per camera: its status, when it was last seen, battery, temperature and network,
with anything worth a look in the notes. It uses the same checks as **Check device status** below.

- Click **Refresh** for the latest status. To have it check every 10 minutes, turn on
  **Automatically refresh device status** in the plugin settings.
- A short line above the chat box keeps the count in view. **Hide** removes it, and opening the
  panel again brings it back.
- When a camera goes offline or comes back, a short notice appears in the chat.

## Check device status

> *"Are my cameras OK?"* or *"Which cameras moved?"*

For a quick look at your cameras, without setting up production counts or targets first, Zira
checks every camera at the sites you choose, including cameras on any kind of line. The page shows:

- **Online or offline**, with how long a camera has been quiet. Cameras that stopped recently come
  first; cameras that have been off for weeks are listed lower down.
- **Power and temperature**: battery level, whether it is charging, temperature and power. A battery
  below 20% that is not charging is flagged. You can ask for another limit.
- **Network**: Wi-Fi, cellular and network cable.
- **Camera and errors**: camera on or off, camera moved, and device errors.

Grey labels are normal and amber ones need a look. Most cameras report these values without a
time, so Zira shows them as the last values it received and asks you to check on site rather than
treating them as confirmed problems. Hover a label to see its full value.

Ask again later and Zira tells you what changed since your last check. Or say *"Check device
status every weekday at 6:30"*, and Zira checks each morning and tells you only when a camera goes
offline, comes back, or reports something new.

![Device status for a pallet plant: one camera that went quiet first, then cameras to check, such as a moved camera, a low battery and a camera that is off.](/docs/ai/zira-plugin/06-device-status.png)

For production counts, trim targets and follow-up tasks, use the health check earlier on this page.

## Show and create tasks

> *"Show my open tasks."*

You get your open tasks from every site you work with, each with its status, priority and a link
to open it in Zira. Narrow it down with *"only high priority"* or *"just Zira Pallet
Manufacturer"*.

> *"Create a task for Bandsaw 3: check the blade and feed. Its cycle time is a third slower than
> the other bandsaws."*

Zira writes the task, links it to Bandsaw 3 and shows you a preview: the title, description,
priority and who it is assigned to. It also tells you if a similar task is already open. Say
**yes** and the task is created. The person it is assigned to is notified, and you get the link.

## Explore your sites, machines and dashboards

Ask Zira to find things for you. Every answer includes links that open the right page in Zira.

- *"Which companies can I see?"* and *"Show the sites for Zira Demo."*
- *"What data sources do we have at Zira Pallet Manufacturer?"* lists every machine, camera and
  form at the site.
- *"Which dashboards cover the bandsaws?"* finds your dashboards.
- *"How did the plant do yesterday?"* reads your dashboards and sums up production, quality and
  performance in a few lines.

## Build dashboards, forms and data sources

Describe what you need. Zira prepares it, shows you a preview, and creates it only when you say
yes.

- **Dashboards**: *"Start a dashboard comparing Bandsaw 1, 2 and 3 over the last 7 days."* Zira
  creates the dashboard with those data sources, then opens it in Zira, where the AI builder adds
  the charts.
- **Forms**: *"Draft a blade-change inspection form."* Zira writes the questions with you and
  opens the form editor with the draft ready for you to review and save.
- **Data sources**: *"Add a Pallet QA data source for the new repair line."* Zira creates it from
  the right template at your site, or opens the data source builder for a custom one.

### Copy a dashboard or data source

> *"Copy the Band Saw 1 dashboard to South Charleston."*

Zira copies a dashboard in the same site, or to another site. For another site, it finds that
site's machines and numbers that match the ones the dashboard uses and shows you the plan: which
machine each one becomes, and anything it could not match. Confirm or change it, and Zira makes the
copy, tells you which charts may show no data, and gives you the link. AI reports are not copied,
so Zira offers to set one up for the new dashboard.

> *"Copy Cam 1 Quality as Cam 2 Quality."*

Zira copies a machine, camera or form in the same site, or to another site or company. Before it
copies, it tells you what stays behind, such as readings, a camera's settings, models and datasets,
and alerts unless you ask for them. A copied camera starts unpaired, and Zira offers to guide you
through setting it up.

## Get AI reports by email

> *"Email me and the shift supervisors a summary of the KPI Overview dashboard every weekday at
> 7:00."*

Zira picks the dashboard charts to read, the schedule, and the people to send it to, and shows you
the plan. Once you confirm, a written summary arrives by email, notification and post on the
schedule you chose.

- **See a sample first.** Before anything is saved, Zira writes a sample report in the chat, so you
  know what your team will receive. It writes a new one after every change.
- **Fine-tune it in Zira.** Ask Zira to open the draft in Zira's agent editor. Change it there or in
  the chat, and schedule it when it reads right.
- **End-of-day reports.** Ask for *"every day at 18:00 with today's data"* and the report covers
  the day that is ending. Morning reports cover yesterday.
- **Focused on its own period.** Each report compares within its period or against your targets,
  and says plainly when a comparison you asked for is not possible.

## Set up and improve Vision

If you work with Zira Vision or Pallet Vision, Zira guides you through the whole journey.

- **Set up a device**: *"Help me set up the new camera on Bandsaw 2."* Zira tells you the next
  step, from pairing and mounting to recording, datasets, training and validation, and gives you
  the right Zira page for each one.
- **Open a dataset**: *"Open the Bandsaw 1 dataset for annotation."* Zira finds the camera and
  dataset by name and opens it in Zira, or its versions, models, training or validation.
- **Check a model**: see **Evaluate a Vision model** earlier on this page.
- **Make a smaller dataset**: *"Make a subset with at least 100 images of each class."* Zira
  builds a balanced dataset and adds it to Zira for you.
- **Find more rare defects**: *"Find more raised nails for Cam 1 Quality."* For Pallet Vision
  cameras, Zira searches recent production images for likely examples and opens a review page. You
  accept or reject each one, and Zira builds a dataset from the accepted images, ready for you to
  add to the camera in Zira. It can also check an existing dataset for labels that look wrong.
- **Test a model on fresh images**: *"How does the newest model do on yesterday's production?"*
  Zira scores the model on a Pallet Vision camera's recent production images, which it has never
  trained on.

## Learn Zira as you go

- Ask any how-to question, such as *"How do I add a widget to a dashboard?"*, and get the answer
  from the Zira help center.
- Say *"Help me get started with Zira"* at any time. Zira asks what you would like help with and
  suggests a first step that fits.
- Say *"Show my Zira preferences"*, *"Change my priorities"* or *"Forget my Zira preferences"* to
  see or change what Zira remembers about your work.
- Say *"Change my default Zira site"* to switch the company and site Zira uses when you do not
  name one.

## Every Zira action

You can start any of these by asking in your own words, or pick it from the `/zira` list.

| In Claude | In Codex | What it does |
| --- | --- | --- |
| `zira:getting-started` | Get Started with Zira | Tell Zira what matters to you, try a useful first step, and save your preferences if you like. |
| `zira:show-companies` | Show Companies | Lists the companies you can access. |
| `zira:show-sites` | Show Sites | Lists the sites of a company, with links. |
| `zira:show-data-sources` | Show Data Sources | Lists the machines, cameras and forms at a site. |
| `zira:show-dashboards` | Show Dashboards | Finds dashboards and sums up what they show. |
| `zira:readings-report` | Readings Report | Answers questions from your readings and builds reports you can save, schedule and share. |
| `zira:evaluate-model` | Evaluate a Model | Scores a Vision model on a dataset, class by class, with every image marked up. |
| `zira:health-report` | Health Report | Checks device health, suggests follow-up tasks and repeats the check on a schedule. |
| `zira:device-status` | Device Status | Shows battery, temperature, camera and network status for every camera, now or on a schedule. |
| `zira:schedule-health-report` | Schedule a Health Report | Sets up a daily health check for chosen sites that stays quiet when nothing changed. |
| `zira:schedule-readings-report` | Schedule a Readings Report | Sets up a recurring report for chosen machines, compared with the period before. |
| `/zira:device-status-panel` | Device Status panel | Opens the Device Status panel for your saved site (Claude only). |
| `zira:show-tasks` | Show My Open Tasks | Shows your tasks across sites, with filters and links. |
| `zira:create-task` | Create a Task | Writes, previews and creates a task. |
| `zira:build-dashboard` | Build a Dashboard | Starts a dashboard from your data sources. |
| `zira:create-form` | Create a Form | Drafts a form and opens the Zira form editor. |
| `zira:create-data-source` | Create a Data Source | Creates a Vision or Pallet QA data source, or opens the builder. |
| `zira:duplicate-data-source` | Duplicate a Data Source | Copies a data source in its site or to another site. |
| `zira:duplicate-dashboard` | Duplicate a Dashboard | Copies a dashboard, matching another site's machines for you to confirm. |
| `zira:schedule-ai-report` | Schedule an AI Report | Emails a written summary of your dashboards on a schedule. |
| `zira:setup-vision` | Set Up a Vision Device | Guides Vision setup one step at a time. |
| `zira:open-dataset` | Open a Dataset | Opens a Vision dataset, its versions or models in Zira. |
| `zira:subset-dataset` | Create a Dataset Subset | Builds a smaller dataset with enough images of each class. |
| `zira:find-defects` | Find Rare Defects | Finds more examples of a rare defect for you to review and turn into a dataset. |
| `zira:zira-help` | Zira Help | Answers how-to questions from the Zira help center. |

Zira team members also see two tools for internal use, **Develop a Vision App** and **Image
Review**.

## You are always in control

- **It asks before it acts.** Anything that creates or changes something in Zira is shown to you
  first, and happens only after you say yes.
- **Your account, your access.** Zira signs in as you and follows your Zira permissions.
- **Your reports stay with you.** Readings and reports are saved on your computer until you
  choose to share them.

## Tips

- **Use names.** "Trimsaw 1" or "the bandsaws at Zira Pallet Manufacturer" is enough.
- **Say the period.** "Past week", "yesterday's second shift" or "since September 1" gets a
  focused answer.
- **Stay in the same chat.** Follow-up questions build on what Zira already found.
- **Ask in the Code tab.** In the Claude desktop app, Zira answers in the **Code** tab, not in Chat or
  Cowork.

## Handy details

- **Every answer links into Zira**, so machines, dashboards, tasks and datasets open on the right
  page with one click.
- **Times use your site's time zone**, so "yesterday's second shift" means what you expect.
- **Reports reuse what they already downloaded**, so loading more weeks stays fast.
- **Reports work offline.** Open a saved report any time, even without a connection.
- **Report links keep working** after the chat is closed.
- **Health and status dashboards are titled with your company and site**, so a shared link says
  what it covers.
- **Scheduled checks stay quiet** when nothing has changed.
- **Weekly reports compare with the week before**, so you see at a glance what got better or worse.
- **Long-quiet devices are listed separately** in the health dashboard, so today's problems stay
  on top.
- **The same actions work in Claude and Codex**, so your team can use whichever assistant they
  prefer.

## Read next

- [AI Dashboard Builder](/docs/dashboards/ai-dashboard-builder) - Finish the dashboards Zira starts for you.
- [Datasets](/docs/ai-vision/datasets) - Review and annotate the Vision datasets Zira opens for you.
- [Home AI Assistant](/docs/ai-assistance/home-ai-assistant) - Ask, find and create from the Zira home page.
