Help

Short guides for arkush at arkush.app. Start with what a dashboard is made of, then bring your data in.

Start here

• How a dashboard works
  The canvas, the blocks, the datasources and their saved rows, and the controls that filter them.
• What arkush is and is not
  What arkush does, what it does not do, and why. Read this before you build on it.
• Directions
  Where arkush can grow, with no dates and no promises.

Guides

• Bring data in
  Files, pasted rows, Google Sheets, BigQuery — and how the data stays fresh.
• Build on the canvas
  Add blocks, edit charts in place, and move blocks where you want them.
• Filter a dashboard
  Controls, clicks that filter, and links that carry your exact view.
• Theme a dashboard
  Give a dashboard a look it carries everywhere, in light and dark.
• Share a dashboard
  Publish a dashboard to the internet, and say how much to trust it.
• Read a dashboard
  What readers see on a dashboard, and what they can do with it, such as pressing ⌘ K to find a dashboard or a datasource, or to run a command from the keyboard.

Work with an AI agent

• Connect your AI agent
  Connect the agent you already use, such as Claude Code. You approve the connection once, and the agent works under your account.
• Work with your AI agent
  How a dashboard looks to your agent, what the agent can and cannot do, and the habits that get good results.

Reference

• What needs the Source panel or an agent
  Which edits have a form in the app, and which are written in the dashboard's JSON.
• Error messages
  What each error message means, who can fix it, and what to do.
• About arkush
  The version these pages describe, where your dashboards are kept, and the third-party notices.
• Changelog
  What changed in each version, newest first.

In the app, the Help panel links to every guide. To open the Help panel, open a dashboard and select Help, the last icon in the icon rail at the right edge of the screen.

For organizations

An organization can run arkush as an org install, on its own server, with its own warehouse access and its own people. These pages are for the people on such a server. On arkush.app, read What differs on an org install to learn what arkush.app does not offer.

• What differs on an org install
  Sharing with people and groups, service accounts, scheduled sends to Slack, and the other things an org install has that arkush.app does not.
• Administer an instance
  For the people who hold the admin right: what each Administration area does, and which settings the people who run the server change instead.