Contents

Guides

Why Does Ritemark Use Terminal AI Agents?

•7 min read

Why Does Ritemark Use Terminal AI Agents?

When you use AI features in Ritemark, the app asks you to install a CLI tool like Claude Code or Codex. These are official terminal agents made by Anthropic and OpenAI. This article explains what they are, why Ritemark uses them instead of building its own, and what that means for your privacy.

What Are Terminal AI Agents?

Terminal AI agents are programs that run on your computer and work with your files directly. Unlike browser-based chatbots where you copy-paste text, terminal agents:

  • Read your files from disk, so you never have to copy-paste content

  • Propose edits and wait for your approval before changing anything

  • Run locally on your machine, not on a remote server

  • Understand context by reading multiple files in your project at once

Claude Code (by Anthropic) and Codex (by OpenAI) are the two agents Ritemark supports. Both follow the same pattern: you give an instruction in plain language, the agent reads your files, proposes changes, and writes them after you approve.

Why Does Ritemark Use External CLIs?

They Are Maintained by the AI Companies Directly

Anthropic maintains Claude Code. OpenAI maintains Codex. These teams ship updates constantly -- new models, better performance, bug fixes. Ritemark gets all of that for free by integrating with the official tools.

If Ritemark built its own AI agent from scratch, every model update would require engineering work on our side. By using the official CLIs, you get access to new AI models on the day they launch, without waiting for a Ritemark update.

Your Documents Stay on Your Machine

Terminal agents run locally. Your files are read from your own disk, not uploaded to Ritemark's servers. Ritemark has no server. The CLI sends only the content needed for each request directly to the AI provider (Anthropic or OpenAI), using your own account and your own authentication.

This is fundamentally different from apps that route your documents through their own backend. With Ritemark, there is no middleman between you and the AI provider.

You Control Your Own Account and Billing

You sign in with your own Anthropic or OpenAI account. You manage your own subscription and billing. Ritemark never sees your API keys, never processes payments on your behalf, and never has access to your AI usage data.

This means you can:

  • Use the same AI subscription across Ritemark and other tools

  • Set your own spending limits in the provider's dashboard

  • Switch providers anytime without changing anything in Ritemark

They Work With Any File, Not Just the Open Document

Terminal agents can read and edit any file in your project directory. That makes them useful for batch operations like translating an entire folder of documents, restructuring a documentation set, or applying consistent formatting across many files.

A built-in AI that only sees the open document would be limited to single-file edits.

Why Not Build AI Directly Into Ritemark?

Building and maintaining an AI agent is a large undertaking. Here is what it would mean:

Slower updates. When Anthropic releases a new Claude model, Claude Code supports it immediately. A custom-built agent would need engineering time to add each new model, test it, and ship an update.

More bugs. AI agents handle complex tasks: file reading, diff generation, permission management, authentication, rate limiting. The official CLIs have dedicated teams testing these features. A smaller team would produce a less reliable tool.

Higher cost for users. Running AI through Ritemark's own servers would mean Ritemark pays for compute and passes costs to you, with markup. By using the official CLIs, you pay the AI provider directly at their published rates, or use your existing subscription.

Security trade-offs. Handling API keys and user authentication is sensitive work. The official CLIs are built and audited by the AI companies themselves. Ritemark avoids this responsibility entirely by letting the CLI handle auth.

What Does Ritemark Add on Top?

Ritemark is not just a pass-through. It adds a layer of convenience and integration that makes terminal agents more accessible:

  • Visual sidebar UI -- chat with AI agents without touching the terminal

  • Agent switching -- pick between Claude Code, Codex, or other agents from a dropdown

  • Document context -- Ritemark passes your open document and project context to the agent automatically

  • Onboarding wizard -- detects missing dependencies (Git, Node.js, CLI tools) and guides you through installation step by step

  • Settings integration -- see agent status, authentication method, and CLI version at a glance

You get the power of terminal agents with the ease of a graphical interface.

How Does Privacy Work?

Here is the data flow when you use an AI agent in Ritemark:

  1. You type a request in Ritemark's AI sidebar

  2. Ritemark passes the request and relevant file content to the CLI agent running on your machine

  3. The CLI agent sends the request to the AI provider (Anthropic or OpenAI) using your account credentials

  4. The AI provider processes the request and returns a response

  5. The CLI agent shows you the proposed changes

  6. You approve or reject the changes

What Ritemark sees: Nothing. Ritemark does not have a server. It does not log your requests, store your documents, or track your AI usage.

What the AI provider sees: The content you send in each request, processed according to their privacy policy. This is the same as using Claude Code or Codex from any other terminal.

What stays on your machine: Your files, your project, your git history. The CLI agent reads files locally and writes changes locally.

Frequently Asked Questions

Do I have to use the terminal to use AI in Ritemark?

No. Ritemark's AI sidebar provides a visual interface for terminal agents. Select an agent from the dropdown, type your request, and the sidebar handles the rest. The terminal is available as an alternative for advanced users.

Can I use AI in Ritemark without installing a CLI tool?

The sidebar AI agents (Claude Code, Codex) require their respective CLI tools to be installed. Ritemark's built-in AI assistant for quick inline edits works independently without any CLI installation.

Is my data safe when using AI agents?

Your files never pass through Ritemark's servers because Ritemark has no servers. The CLI agent sends content directly to the AI provider using your own account. Check the privacy policies of Anthropic and OpenAI for how they handle data.

Which agent should I choose -- Claude Code or Codex?

Both are capable AI agents. Choose based on your existing subscription:

  • Have a Claude Max subscription? Use Claude Code.

  • Have a ChatGPT Plus or Pro subscription? Use Codex.

  • Have both? Try each and pick your preferred experience.

You can switch agents at any time from the sidebar dropdown.

Will Ritemark support more agents in the future?

Ritemark's architecture is designed to work with any CLI-based AI agent. As new agents become available from other providers, they can be added to the sidebar.

What happens if I do not install any AI agent?

Ritemark works perfectly as a markdown editor without any AI agent installed. AI features are optional. You can write, edit, and manage documents without them.

Back to support
Why Does Ritemark Use Terminal AI Agents?