SUPPORT
Help with Vibedoro
For help with Vibedoro, email dexter.yao23@gmail.com. Vibedoro is developed and operated by Shuhao Yao.
Start and end focus
Open Vibedoro from Applications or the Dock. The island sits at the top of your selected screen. Click its left side to expand it; click the expanded left side to collapse it.
Choose a goal, a task for today, or just focus. Set a timed session or choose No timer, choose Focus with agents or Deep focus, then start. Stop saves your actual focus time after at least one minute. Cancel discards the current session. Ending focus does not mark a task complete; check it separately in Today.
Choose the focus type that matches how you want to work. During direct focus or focus on a single target, switching types keeps the clock and target. A focus block shared by two tasks uses Focus with agents.
Focus with agents. Work with AI to make progress. Available agent context stays in view.
Deep focus. Read, think, write or build independently. Agent signals stay out of view. Deep focus also pauses agent reads inside Vibedoro. Your agents and notifications from other apps continue as usual.
Review your recorded focus
Choose a day, week or month in Review, then choose By day, By goal or By focus type. Open a focus-type bar to see its dated records and allocated minutes. A session that changed type can appear in both categories, with only its share of the time in each. Time without a recorded type stays under Mode not recorded. Your current session contributes after it is saved; switching type does not rewrite earlier records.
Export your data
In Settings → System, choose Export data and select a folder. Each export creates one timestamped JSON file named vibedoro-export-YYYYMMDD-HHMM.json, containing your goals, daily tasks, repeat rules, recorded focus and message counts. Your coding agents can read it to answer questions about your work. Exporting is free and happens only when you choose it. Read the Agent reading guide for the schema, timestamps, coverage, and instructions you can share with your own agent.
Connect an agent
Codex is supported by default. In Settings → Agents, choose Connect for Codex and select ~/.codex in the macOS folder picker. The connection is read-only and optional. Cancelling the picker leaves it unconnected. You can focus without connecting any agent.
For Claude Code, open Settings → Agents, review detected terminal and desktop installations, then choose Connect Claude Code and select your actual ~/.claude folder. Detection alone grants no access. One managed connection serves both surfaces. Vibedoro installs only its bundled hooks, preserving unrelated settings. Use Detect agents again after installing or reinstalling an agent. Use Repair if a managed connection needs attention. Claude currently supplies message counts; sessions, waiting states and quota remain unavailable.
For another coding agent or a personal assistant, choose Add Agent, copy the connection instructions and paste them into that agent. It can publish a sanitized local export and explain which capabilities it can reliably provide. After it creates ~/.vibedoro/agents/<id>.json, choose Connect Agent exports in Vibedoro and select ~/.vibedoro/agents once. No skill installation, GitHub login, password or login token is required by Vibedoro. Copying a prompt alone does not grant macOS folder access. Your agent should explain and obtain your approval for any additional tools, permissions or background updater it needs.
Main and Settings rescan about every 20 seconds while watched. Refresh agents in Settings requests another scan. Review refreshes message counts normally every five minutes; Deep focus pauses Vibedoro’s agent monitoring, including manual refresh. It does not stop Claude’s independently invoked publisher or other agents. Sessions and quota expire independently, so an export can stay connected while live readings become unavailable.
If a bookmark expires, use Connect again for that source. An unreadable source may need its folder or permissions restored; reconnecting does not resolve every error. Do not grant a broader folder or send a login credential to troubleshoot it. Unknown activity does not mean an agent is idle, and a blank quota does not mean your allowance is zero. Quota is shown only when reliable evidence is available; Codex waiting states are not available from its native records.
To remove a managed Claude connection, choose Remove in Settings → Agents. Vibedoro removes only its recorded hooks and live export; unrelated settings, native transcripts and saved message counts stay intact. An existing external Claude publisher is not silently taken over. To remove a generic agent connection, ask it to remove only its own updater and <id>.json. Vibedoro stops monitoring it after a complete rescan and preserves previously saved message counts. Codex and generic export connections have no bookmark-removal button. History is not deleted automatically. Lists show at most ten row slots before scrolling additional agents.
Review offers By Agent and By project views of the same message counts. Select an agent to see it across projects, or combine the two filters. Messages without a project appear under Unassigned. One activity chart follows your selection; conversation details open only when you choose them. Missing evidence is shown as unknown, rather than zero.
A record did not save
A save error is not a successful booking. Keep the original data in place and describe the action and error shown when contacting support. Do not delete or overwrite your history to hide an error.
What is free and what a subscription adds
Manual planning, focus sessions, Review, agent status and quota, data export, settings and source connections are free. In the manual planning edition, Free supports two active goals and Pro supports five. Both tiers share a limit of 30 daily tasks, and you can add tasks after completing part of your list. Earlier versions can have different limits.
Free includes Rain, Brown noise and the Dark theme. Pro also includes Ocean, Stream, Forest and Café, and lets you save the Light theme. If a subscription ends, your records remain available and a running focus session can finish. To add or reactivate a goal, first bring the active count below the Free limit. A premium theme can be previewed in Settings and premium soundscapes auditioned there without a purchase; a premium soundscape already saved as your preference is not played for a new focus session until the subscription is active again.
Monthly, quarterly and yearly plans include the same features and renew automatically unless cancelled. Quarterly and yearly plans are charged once for each full period. There is no free trial. The purchase screen and Apple’s confirmation show the price and billing period for your storefront.
Vibedoro is being prepared for the Mac App Store. The official link will appear on the availability page when ready. Downloads and updates use the Mac App Store; there is no direct installer.
Restore purchases
Use the Apple Account that made the purchase. In Settings → Subscription, choose Restore purchases and follow any Apple sign-in instructions. A pending or unverified purchase may not yet provide access. If access is still unavailable, check the subscription in your Apple Account and contact support with the app version and the message shown.
If a purchase cannot currently be verified, Vibedoro may show access as unknown. Offline access depends on verified Apple information and its original expiration or grace deadline; the app does not add a separate offline allowance. Billing retry alone does not provide access. A valid grace period must be confirmed by Apple. Restoring or retrying cannot extend an expired subscription.
Choose Manage subscription to open Apple’s subscription page. Restoring purchases restores eligible subscription access. It does not recover local goals, tasks or focus history from another Mac.
Cancel renewal
On your Mac, open the App Store and click your name at the bottom of the sidebar. On the page that appears, click your name again, then Subscriptions. Select Vibedoro and choose Cancel Subscription. You may need to sign in. If Apple shows an expiration message without a cancel option, renewal is already cancelled. Apple’s current cancellation instructions include regional exceptions.
To avoid a renewal charge, Apple advises cancelling at least 24 hours before the current period ends. Cancelling renewal is separate from requesting a refund. Access to an already paid period normally continues until its expiration, subject to refunds, revocation and applicable regional rules.
Request a refund
For an Apple purchase, sign in at reportaproblem.apple.com, choose Request a refund and select the purchase. Apple decides eligibility and processes approved refunds under the applicable rules. A pending charge may not yet be available for a refund request. See Apple’s refund instructions.
We cannot promise that a refund will be approved or when it will reach your payment method. These instructions do not limit your rights under applicable consumer law. Removing Vibedoro does not cancel an Apple subscription.
Sound and motion
Choose a soundscape in Settings and check your Mac’s output volume. Rain and Brown noise are free; the other focus soundscapes require subscription access. You can always adjust saved preferences, volume or Stop. Sounds play from files included with the app. Motion follows Vibedoro’s animation preference and macOS Reduce Motion.
Prepare a support request
Include the Vibedoro version and build if available, macOS version, what you tried, what you expected and what happened. Mention the interface language and relevant source connection. A cropped screenshot is optional; remove private names and conversation details first.
Do not send passwords, tokens, keychain exports, full transcripts or the app’s data folder. These are not needed for an initial report.
The App Store app is licensed under Apple’s Standard EULA, unless its App Store listing specifies a custom agreement. Apple purchases are also subject to the terms for your storefront.
