Multica Go

App usage tips

Plug Multica Go into your workflow

Multica Go registers an iOS URL Scheme. Other apps, Siri / Shortcuts, the home-screen widget, web pages, and macOS tooling can all open a specific screen in Multica Go through a link. This page starts with the URL Scheme guide, and more tips will be added over time.

Back to home

Scheme name

multicago://

iOS Bundle ID: cn.alanhe.multicago. It is declared in Info.plist under CFBundleURLSchemes. iOS routes multicago:// to Multica Go.

Usage form: multicago://<host>. The host is owned by Multica Go; tapping a link switches to the correct tab and pushes the target screen.

Common triggers

  • Home-screen widget tap
  • Siri / Shortcuts "Open URL" action
  • External web page <a> link
  • macOS Terminal open multicago://

Currently supported URLs

All URLs follow the multicago://<host> pattern. Multica Go automatically switches to the correct tab and pushes the target screen. Multi-server setups can pass ?server=<host> to switch the active server, and the equivalent https://multica.ai/... paths open the app via Universal Links.

  • Usage dashboard

    multicago://usage

    Switch to the Home tab and push the Usage screen. The home-screen widget uses the same link.

  • New chat session

    multicago://new-chat

    Open the Chat tab on the new-session composer — handy from Siri or Shortcuts when you want to start an Agent conversation immediately.

  • Open an issue

    multicago://issues/{id}

    Pass an issue id to open its detail screen. In multi-server setups, append <code>?server=&lt;host&gt;</code> to switch the active server first.

  • Open a project

    multicago://projects/{id}

    Open the project detail view with its resources, members, and issues.

  • Open a pull request

    multicago://prs/{id}

    Multica Go does not have a dedicated PR view yet — the link falls back to the issue detail screen so you can review context first.

  • Resume a chat session

    multicago://chat?id={id}

    Pass the chat session id via the <code>id</code> query parameter to drop into the matching conversation.

  • Add a server

    multicago://add-server?baseURL={baseURL}&webURL={webURL}

    Pass <code>baseURL</code> (required) and <code>webURL</code> (optional) to open the Add-Server flow — a quick way to share self-hosted or partner Multica deployments so they can be imported in one tap.

This list mirrors what the current App build handles today. Use the in-app feedback form to request more hosts.

Usage

The Usage page is the source for token metrics like total tokens, cost, runtime, and task count. You can open it from Me, the home usage card, or multicago://usage.

Entry and screen coverage

  • Entry points: Me -> Usage, the Usage card on Home dashboard, or deep link multicago://usage.
  • Main screen supports time windows: This Week / Previous Week / This Month / Previous Month / Last 7 days / Last 30 days / Last 90 days / Last 365 days.
  • You can switch metrics between Tokens, Cost, Runtime, Tasks, and filter by project.

Refresh and sharing state

  • The page initializes via loadIfNeeded(); pull-to-refresh triggers force: true reload.
  • Changing range or project also requests a refresh to keep the chart and summary in sync.
  • Top bar includes Share Usage to export a snapshot image.
  • After successful reload, monthly usage totals are written to the App Group cache for home/lockscreen widgets.

Usage data is loaded on first enter and can be refreshed with pull-to-refresh or filter changes.

Home Screen / Lock Screen Widgets

Use home screen and lock screen widgets for a quick usage summary and trends at a glance.

Home Screen Widgets

  • Supported widgets: Usage Summary and Token Trend, sizes systemSmall and systemMedium.
  • Each widget can be configured with Daily / Weekly / Monthly period.
  • Data is sourced from active server/token and aggregated from /api/dashboard/usage/daily.
  • Timeline refresh request is scheduled every 30 minutes; WidgetKit decides actual execution timing.
  • On network failure, stale-cache fallback is shown when period matches, and each widget links to multicago://usage.

Lock Screen Widgets

  • Supported widgets: Monthly Token Usage and Weekly Token Usage for accessoryRectangular, accessoryCircular, and accessoryInline.
  • They show total tokens for this month / this week with compact text rendering.
  • Same aggregation pipeline as home widgets is shared, also based on daily usage data.
  • They follow the same 30-minute timeline policy under system scheduling and fallback to matching cached snapshots when needed.
  • Tap target also opens multicago://usage.

Home and lock screen widgets share the same aggregation path and open Usage page directly via multicago://usage.

Trigger from other apps

Common ways to invoke Multica Go from outside the app:

Siri / Shortcuts

In the Shortcuts app, add an “Open URL” action with multicago://usage (or any other supported host) to jump straight to the matching screen.

Web pages or blog posts

Use <a href="multicago://usage">Open usage</a> in HTML. iPhone Safari will prompt to open it in Multica Go.

macOS Terminal

On macOS, run open multicago://usage in Terminal — Handoff will launch Multica Go on the paired iPhone.