Skip to content
Choose your AI agent

DocsGet started

Choose the AI agent AppNorth uses

AppNorth runs its AI features through an agent CLI on your Mac: Claude Code, Codex, Gemini CLI, OpenCode, Cursor, Grok or Ollama. Set one up in a few steps.

Updated November 18, 2026View as Markdown
On this page
  1. How AI works in AppNorth
  2. Supported agents
  3. Set it up
  4. Settings you can change
  5. When your AI usage runs out
  6. Questions

How AI works in AppNorth

AppNorth has no AI of its own and sells no AI credits. It runs an AI command-line tool (CLI) already installed on your Mac, with your own subscription, API billing or local model. Your provider’s limits, charges and data handling apply.

The AI brainstorms keyword ideas, drafts and localizes listing copy, and answers in researcher chat. The MCP server is a separate connection that lets an external agent use AppNorth’s tools. You can use either one, or both.

Supported agents

AppNorth works with these AI CLIs:

  • Claude Code (claude)
  • Codex (codex)
  • Gemini CLI (gemini)
  • OpenCode (opencode)
  • Cursor (cursor-agent)
  • Grok (grok)
  • Ollama, while it is running with at least one model downloaded

Set it up

  1. Install the CLI you want, following its provider’s instructions.
  2. Open Terminal, run the CLI once and sign in. AppNorth can’t show whether a CLI is signed in, so do this first.
  3. In AppNorth, open Settings → AI, or the Choose your AI step during setup.
  4. Pick your provider. Only installed CLIs can be selected; the others show Not found.
  5. Optional: choose a Model and a Reasoning effort. By default AppNorth uses the model your CLI runs by default.
  6. Click Test. AppNorth asks the AI to reply “AppNorth is ready.” and shows the answer.

Settings you can change

Settings → AI also holds these options:

  • Model: the CLI’s default, one of the models the CLI reports, or a custom one.
  • Reasoning effort: used when the selected CLI supports it.
  • Simultaneous AI runs: how many AI tasks run at once. Queued and paused tasks don’t take a slot. Default: 2.
  • Research markets: the countries AppNorth uses for country research. Choose at least one.

When your AI usage runs out

If your provider reports that your usage is exhausted, AppNorth pauses the task and shows when it resumes. If the provider doesn’t say, it retries in 15 minutes.

Click Resume now to try again earlier, or switch to another installed AI CLI. Switching needs a CLI with a confirmed sign-in.

Questions

Do I need a paid AI plan?

AppNorth includes no AI subscription or credits; AI use counts against your own provider’s plan. With Ollama, a local model runs on your Mac instead.

What if no AI CLI is found?

Install one, for example Claude Code, sign in to it once in Terminal, then click Check Again. You can also continue without AI.

What happens without an AI agent?

You can skip the AI step and choose one later in Settings → AI. Without it, keywords for new countries are localized with AppNorth’s dictionary and DeepL, if you saved a key; localizing listings, drafting and brainstorming need an AI first.

The AI fails with “The AI CLI could not complete the task.”

The CLI is often signed out. Run it in Terminal, sign in again, then click Test in Settings → AI.

Can Grok connect to AppNorth through MCP?

Not yet. Grok can run AppNorth’s AI features, but AppNorth can’t add itself to Grok as an MCP server until Grok documents its MCP configuration format.