Hedoq documentation
How to work with Hedoq: one page per task.
Hedoq is a free app for Mac and iPhone where Claude Code, Codex, Gemini and OpenCode work in one window. Start with the install, then open pages as you need them.
Getting started
- Install and first session: from download to the agent’s first reply.
- Agents and subscriptions: which agents work, how to connect Claude, ChatGPT and your own models.
- Components and macOS access: what installs with one click and which permissions are needed.
Sessions and agents
- New session and project: agent, Hedoq Space, the session list.
- Feed and terminal: replies, questions as buttons, permissions, helpers.
- Switching models: another model in the same session.
- Refresh session: a long task with a clean context.
- Parallel sessions: a project copy per session and the Changes window.
- Linked sessions: give a task to another session.
- Model council: one task for several AI models.
- Incognito: a conversation with no traces on your Mac and iPhone.
- Brief answers: the starter set of rules for agents.
Mac: notch, voice, meetings
- Notch and limits: subscriptions and sessions by the notch, the shelf.
- Voice: dictation everywhere, vocabulary, answers read aloud.
- Meeting recording: a transcript by speaker and Summary.md.
- Lid closed: the Mac keeps working while you are on the move.
- Session browser: the project’s site right in the window.
- Files: the project tree, an editor, images in the feed.
iPhone
- Hedoq on iPhone: pairing with your Mac and answering agents.
- Agents using your phone: reminders, calendar, message drafts.
- Dynamic Island: limits and sessions in the island and on the Lock Screen.
Automations and tools
- Automations: scheduled tasks with a watchdog and a chat.
- Telegram: bots, and your own account for the agent.
- Agent tools: Google Sheets and other MCP servers.
- Servers over SSH: servers, keys, connection checks.
- Keys and passwords: secrets in Keychain.
Data and security
- Privacy: what stays on your Mac and what goes over the network.
- Troubleshooting: what to do when something does not work.