Contents

Guides

Set Up AI Assistant

6 min read
Ritemark's welcome, step 1: Which AI do you use? with ChatGPT, Claude and OpenCode

Pick an agent for the AI sidebar and sign in. Claude Code, ChatGPT and OpenCode all ship inside Ritemark, so there is nothing to install.

Ritemark's AI sidebar runs three agents: Claude Code, ChatGPT and OpenCode. They read and edit the files in your folder, right next to your document. All three are bundled with Ritemark. You only sign in to the one you want, or give it your own API key.

The app is free. Each agent runs on your own plan or key.

What You Need

Agent What you need How you connect
Claude Code A paid Claude plan (Pro, Max, Team or Enterprise), or an Anthropic API key Sign in with Claude.ai in your browser, or paste the API key
ChatGPT Your ChatGPT account (any plan; Free has tighter limits) Sign in with ChatGPT in your browser
OpenCode Your own API key from OpenAI, Google AI, Anthropic or OpenRouter Paste the key in You ▸ Settings

The free Claude plan does not work in the sidebar. Any ChatGPT account works, Free included. Paid plans get higher limits. You also need an internet connection while you chat with an agent.

You can set up one agent or all three, and you can switch agents in the middle of a conversation. The model menu under the message box shows the agent and model you're on, and when one conversation uses more than one agent, each answer names the agent and model that wrote it.

Step 1: Open the AI Sidebar

The very first time you start Ritemark, the welcome asks Which AI do you use? For ChatGPT and Claude, click Sign in, or Continue if you are already signed in. OpenCode has Set up. API keys lets you use Claude with an Anthropic API key of your own, and Skip for now goes on without an AI. Each AI shows Checking… until its check answers. If a check doesn't answer within 20 seconds, choose Try again.

After the welcome:

  1. Open a project, a folder with your documents
  2. The AI has its own sheet in the column on the right of the window
  3. Pick a Claude, ChatGPT or OpenCode model in the model menu under the message box. It shows the agent and model you're on.

If you skipped the welcome's AI step, sign in from You ▸ Settings, as below.

Step 2: Sign In

Claude Code

  1. Pick Claude in the sidebar, or open You ▸ Settings and find Claude Account
  2. Click Sign in with Claude.ai. Your browser opens the Anthropic sign-in page
  3. Approve the sign-in and return to Ritemark

The sidebar and Settings both show that Claude is connected. To use an Anthropic API key instead, click Use API key instead and paste your key.

Ritemark Settings, API Keys: the Claude Account card, Connected, signed in with Claude.ai

The Claude Code that ships with Ritemark needs neither Git nor Node.js, on Windows too. Ritemark checks for Git for Windows only if you choose your own Claude install under Settings → Agent Runtime → Runtime preference → Use system install.

Details: How to Set Up Claude Code.

ChatGPT

Ritemark says ChatGPT wherever it names this AI. Underneath, it runs OpenAI's Codex.

  1. Pick ChatGPT in the sidebar, or open You ▸ Settings and find ChatGPT Account
  2. Click Sign in with ChatGPT. Your browser opens the OpenAI sign-in page
  3. Approve the sign-in and return to Ritemark

Settings and the sidebar stay in sync. Signing out in one place signs you out in both.

Details: How to Set Up Codex.

OpenCode

OpenCode has no sign-in of its own. It uses API keys you already have.

  1. Open You ▸ Settings (⌘, on a Mac, Ctrl+, on Windows) and find the API key fields
  2. Paste a key for OpenAI, Google AI, Anthropic or OpenRouter and press Enter
  3. In the model menu under the message box, pick a model from the OpenCode group

Only providers with a saved key show up in the OpenCode group. The list refreshes as soon as you save a key.

Details: Set Up OpenCode.

Step 3: Try It

  1. Open a document in your folder
  2. Type a request in the sidebar, like "summarize this document in five sentences"
  3. The agent reads the file and answers in the chat

Choose How Much the Agent May Do

The mode control in the composer decides whether the agent asks first:

  • Auto (the default): the agent edits files and runs tools without asking. You review the result.
  • Manual: the agent asks before each file change or command.
  • Plan only (Claude and ChatGPT): the agent writes a plan first, and nothing changes until you approve it.

See AI Sidebar for everything the sidebar can do.

Troubleshooting

Problem Solution
Sign-in does not finish Check that your browser opened the sign-in page, finish it there, then wait a few seconds. If it times out, start the sign-in again.
Claude Code will not connect with a free Claude account The free Claude plan does not include Claude Code. Use a paid plan or an Anthropic API key.
ChatGPT sign-in fails Check that your browser opened the sign-in page, and that you signed in with the ChatGPT account you meant to use.
The OpenCode group says "Add API keys to use OpenCode" Save at least one provider key in Settings.
"Offline" banner or AI Offline in the status bar Check your internet connection, then click Check again.
Windows: "Git for Windows not detected" Shown only with Use system install, because a Claude you installed yourself may need Git Bash. Install Git for Windows, or set Runtime preference back to Bundled.

More fixes: Common Issues.

API Keys for Flows

Flows are separate from the sidebar. Their LLM and Image nodes use your own OpenAI or Google AI key. Add the key in Settings. The same key can also be used by OpenCode.

Privacy Notes

  • Your documents stay as plain files on your computer. Ritemark has no cloud for your documents.
  • Whatever the agent reads goes to the provider behind the agent you picked: Anthropic for Claude Code, OpenAI for ChatGPT, and the provider whose key you use in OpenCode. That includes your prompt, the open file, selected text, attachments and any other files the agent opens.
  • Sign-in tokens and API keys stay on your computer, in your system's secure credential store.
  • Requests go straight from your computer to the provider, not through a Ritemark server.
  • Anonymous usage data is on by default. You can turn it off on the welcome, before anything is sent, or any time in Settings ▸ Usage data. It never includes file contents.

See AI Information in Ritemark for the full picture.

Without AI

Ritemark works fine without AI:

  • All editing features work
  • Share works: PDF, Word, Google Docs and copy as Markdown
  • CSV/Excel viewing works
  • Only the AI sidebar needs a plan or key

You can always set up an agent later.

Back to support