Support

Answers to common questions, and a way to reach a real person if you’re stuck.

Get in touch

Email us and we’ll usually reply within two business days.

hello@kitomer.app

It helps to include your organization’s name, the place or incident you’re asking about, and, for the iPhone app, your iPhone model and iOS version.

Getting started

How do I set up a new organization?

Create an account at kitomer.app with email or Google, finish your profile, and create an organization. Then:

  • Connect GitHub, Fly, or Cloudflare from the setup wizard. Sentry is connected from Integrations.
  • Link your repos, apps, and resources to places. Coverage shows what is still unlinked, and the map shows what isn’t on the canvas yet.
  • Turn monitoring on for each place and set its health URL and interval. Heartbeats start within five minutes.
  • Invite people and assign a responsible person on each place.
  • Build a schedule and an escalation policy. Each person verifies a contact method and sets a paging rule.
  • Add a channel, like Slack, and an alert policy.
  • Connect your AI from AI Connections.
What can each person do?
  • Observer: open the app and read. Cannot acknowledge, declare, or edit.
  • Member: everything an observer can, plus respond: notes, declare, acknowledge, incident updates, maintenance, and covering their own on-call.
  • Admin: everything a member can, plus manage places, the map, integrations, schedules, escalation, channels, policies, and members.
  • Owner: everything an admin can, plus the vars token, deleting the organization, and promoting another owner.
  • Designee: a named person who can be assigned and paged but cannot sign in.

Places and heartbeats

What is a place?

A place is anything on your map: an app, website, API, worker, data store, external dependency, or other. Each has one environment (staging, UAT, or production), a responsible person, tags, and optionally a health URL that Kitomer checks. Who is responsible for a place is separate from who is on call this hour.

How often are places checked?

Every 1, 5, 10, 15, 20, 30, or 60 minutes, as you choose for each place. Each check is a GET of the health URL, and stores up or down, the HTTP status, latency, and the probe detail. Owners and admins can run a check right away from the place. Turning monitoring off stops scheduled checks for that place.

A place looks down, but Fly says the app is healthy.

If Cloudflare proxies the domain in front of /health, the proxy can make a healthy Fly app look down. Open the place’s Recent checks to see the request and response, and compare with the app’s own Fly hostname. Help in the portal walks through it.

How do links get on the map?

Owners and admins draw a link between two cards, or generate links from domains or from vars. Each link can have a label, a solid or dashed line, and a side for each end. The map is one canvas per environment.

On call and paging

How does a page escalate?

An escalation policy is a list of steps. Each step pages its targets, then waits its delay for an acknowledgement before moving on. Targets can be the principal, the backup, a person, the org admins, or all responders. The default is the principal, then the backup, then the org admins. The ladder can repeat up to five times, and a step with nobody to page is skipped.

What do the severities mean?

SEV1 skips delays and reaches every verified method a person has. SEV2 and SEV3 follow the escalation ladder and each person’s own delays. SEV4 posts to channels only and pages nobody.

How do I choose how I get paged?

Open Notification settings from your profile. Add email, SMS, or voice and enter the 6-digit code; unverified methods are never paged. Browser push is set per browser, and the iPhone app adds itself. For each method choose on or off, a delay, and a minimum severity. A typical ladder is push now, SMS after two minutes, a call after five. Send me a test page checks the whole path.

What happens when nobody is on call?

Hours with nobody on call are shaded on the week grid, and On Call warns when the next seven days have gaps. A page during a gap skips to the next escalation step.

Can I cover for someone without changing the schedule?

Yes. An override puts someone on call for a window without editing the pattern, and a swap exchanges two shifts. Take on-call now starts an override from now. Members cover themselves; owners and admins assign anyone.

Can I see my shifts in my calendar?

Yes. Add to calendar on On Call gives you a private iCal link of your own shifts.

Incidents

How does an incident open, and how does it close?

A health check crosses an alert policy, an inbound webhook fires (Sentry, Cloudflare, Datadog, or a generic webhook), or a person declares one. A health-check incident closes when the place recovers. An inbound one closes on the vendor’s “resolved” event. A declared incident stays open until a person resolves it.

Where can I acknowledge a page?

In the portal, in Slack, in the iPhone app, by replying ACK, 1, yes, or ok to the SMS within 24 hours, by voice, or through your AI with the Kitomer MCP. The link in an email or SMS asks you to confirm, so a link scanner can’t acknowledge for you. Acknowledging stops escalation and leaves the incident open.

How do I stop pages during planned work?

Schedule a maintenance window from Incidents or from the place, for one place or every place, for up to seven days, with a reason. Checks keep running, and no new incident opens during the window.

What goes into the investigation?

Findings (a hypothesis, evidence, or a next step) from people or from your AI, similar past incidents on the same place, a write-up, and follow-ups. Create GitHub issue opens an issue in the place’s repo, and closing that issue marks the follow-up done.

iPhone app

Can I create an account in the app?

No. Create your account and organization at kitomer.app first, then log in on your iPhone with email and password or Continue with Google.

How do I add the widget?

Touch and hold the Home Screen, tap Edit, then Add Widget, and choose Kitomer in small, medium, or large. On the Lock Screen it comes as a circle, a rectangle, or inline. The widget follows the organization and environment you last chose in the app.

The widget shows a time in yellow.

That means it couldn’t reach Kitomer, so it’s showing the last saved data and when it was saved. Open the app with a connection to refresh it.

What can I do on the phone, and what is web only?

The app covers places, incidents, on-call, and your notifications. The map, coverage, SBOM, insights, integrations, AI Connections, organization settings, and plans are in the portal, as are editing places, schedule patterns, and escalation and alert policies. Screens in the app link to the same place or incident on kitomer.app.

Your AI

Which AI clients work with Kitomer?

Any client that supports remote MCP servers. AI Connections has one-click setup for Cursor, Claude, OpenAI, Bolt, Lovable, Replit, and Base44. The endpoint is https://mcp.kitomer.app/mcp. See Your AI for every tool.

Can my AI change things?

Only what you could change yourself. The MCP signs in as you, and writes follow the same roles as the portal. Kitomer does not deploy, and it does not change secrets.

Accounts and plans

How much does Kitomer cost?

Every organization starts on a 30-day Free trial. Paid is $12 a month and Enterprise is $35 a month. SMS and voice paging and inbound alerts are off on the Free trial. Anyone in the organization can see its plan under Organization → Plans; owners and admins request an upgrade there.

How do I delete my account?

Email privacy@kitomer.app from the address you sign in with. Owners can delete an organization from Organization → Overview. More in the Privacy Policy.

Ideas and feedback

Got an idea for Kitomer, or something that doesn’t work the way you expect? Send it our way.