Start on your Mac: install the app, connect your AI, then open Sessions. You do not need glasses or local voice to begin.
Not ready to set up a Mac? Open COS Glasses on your iPhone and tap Start here. It runs on your phone, no account needed. Connect a Mac later for Sessions, meetings and memory.
Check these before you start
COS Control on an Apple silicon Mac with macOS 14 or later and an internet connection.
Even G2 glasses and an iPhone are optional. Add them after your Mac is ready.
Keep your Mac awake when you want to reach its server from your glasses.
One signed-in AI provider: the Codex Mac app, Claude Code, or Cursor Agent. New to AI coding apps? Install Codex for Mac and sign in, then return to COS and choose Check again. Claude Desktop alone does not supply Claude Code.
Optional voice and media setup
whisper.cpp and about 6 GB free for voice prompts — run brew install whisper-cpp once. The setup command verifies disk space before downloading anything. This is required for local voice; text chat works without it.
Local spoken replies on Apple silicon — optional: run brew install python@3.12 ffmpeg espeak-ng. Python 3.11 or 3.12 is supported. The normal server start provisions Kokoro asynchronously; chat and transcription work while it prepares.
ffmpeg for photos — the command above also covers phone photos, answer-image galleries, and manual 288×144 G2 image viewing. Text and transcription still work without it.
Came here from the Even Hub? You already have the app half — the server in Step 1 below is the missing piece.
Easiest path: COS Control. A menu bar app for the Mac that installs the server for you, keeps it running, launches at login, and updates and rolls back safely. No terminal to babysit. Step 1 below starts with it; the terminal command stays as the alternative. Download COS Control (macOS 14 or later, Apple Silicon).
Your first session on Mac
New Mac or existing COS setup: start with the app. It detects an existing server before offering setup, so you keep your current work.
ServerInstalled by the Mac app
AIYour signed-in provider
Glasses & voiceAdd them later
1 · Open COS Control on your Mac
The easy way: COS Control. A menu bar app that installs the server, keeps it running, launches at login, and updates and rolls back safely. Most people should start here.
Download COS Control (macOS 14 or later, Apple Silicon), unzip it, and move it into your Applications folder. The Control page has the checksum and the details.
Open COS Control from Applications. The current download is Developer ID signed and notarized by Apple. When updating manually, quit the old Control first and choose Replace in Applications. Keep rollback copies outside Applications and open only the installed COS Control.app.
Sign in to a supported AI provider if prompted, then choose Get started. COS prepares and starts the server. When it is ready, choose Open Sessions. Add local voice separately before testing voice prompts or meetings.
Developer alternative: run the server in Terminal
Or the terminal. The same server, running in the foreground. Keep the window open while you use the glasses.
$ npx --yes @gotcos/glasses-server@latest --setup-transcription --transcription-tier balancedclick to copy
The terminal prints your server URL (Tailscale and Wi-Fi addresses, labeled) and your API token — you'll paste those into the app in Step 2. The token is saved to ~/.cos-glasses/.env. For transcription, install whisper-cpp first and have about 6 GB free; setup verifies space, then provisions Small.en preview, Turbo commit, and Large-v3 HQ models. For optional local spoken replies on Apple silicon, run brew install python@3.12 ffmpeg espeak-ng; the server validates and self-repairs its pinned Kokoro environment.
2 · Start a task and open Sessions
Start a task in your signed-in AI app. In COS Control, choose Open Sessions to follow it and continue the conversation.
Cloud Puff and its Running, Done and Waiting ledger help you follow active work. No glasses or voice downloads are needed for this step.
If setup cannot finish, check your internet connection and choose Try again. Use Run checks in the menu-bar app for a specific error.
3 · Add your work when you are ready
Choose your Work folder and, if you have one, your Meetings folder in COS Control.
Keep using Sessions, or add glasses, voice and personal context below. These do not block core Mac setup.
Add your glasses (optional)
Connect the app on your iPhone
Once COS Control shows the server running, use Copy pairing token. The token stays on the clipboard for 60 seconds.
Open the Even Realities app → Even Hub → install COS Glasses.
Open it and enter the server URL and API token (or tap "I have a COS username" and skip the typing). The URL is http:// your Mac’s address :3141: the terminal prints it; with COS Control, use the Mac’s Wi-Fi address from System Settings or its Tailscale address. The token is what the terminal printed, or what Copy pairing token put on the clipboard.
Tap Connect.
Try the glasses
If the terminal showed LOCAL VOICE NOT READY, or Guided setup said whisper-cpp is missing, run brew install whisper-cpp, then rerun the server command (Ctrl-C first) or run Guided setup again in COS Control before your first voice prompt.
Learn tap-and-hold: tap and release, then quickly press again and keep holding for the shortcut window above the HUD. The default COS order is Home, Ask COS, Start Meeting, Model, Messages, Sessions, then Tasks. Scroll and tap to select. While recording, Home, Resume Meeting and Stop Meeting lead; Tasks stays in Quick Actions instead. Practice the hold gesture.
Ask. On the glasses, tap and hold, choose Ask COS, and say "brief me". The answer lands on the lens.
Meeting. Tap and hold, choose Start Meeting, talk for a minute, then Stop. Takeaways and action items appear.
Session. Start a task in Claude Code on your Mac. On the glasses, tap and hold, choose Sessions. Watch it run, then Continue or Cancel from the ring.
Practice the page-specific controls: in a reader, tap once for footer choices, scroll, then tap again to confirm. This is not the quick double-tap that starts a referenced reply. Tasks and Sessions have rolling footer menus; task wrapping needs glasses 6.9.455+. Try Messages, Sessions, Tasks, and Ask COS with the simulated ring.
Optional photo proof: tap the camera, stage one photo, ask "What am I looking at?", then open its phone gallery. Turn on Lens images to test the manual G2 preview.
Already run a COS from the Starter Kit? Choose that folder as your Work folder in COS Control. For a manual terminal installation, run the server command from that folder. New users can add the optional Starter Kit after their first session.
Already have meeting files? After setup, open COS Control and choose Meetings folder. The recommended path is simply the folder that already contains your YYYY-MM/*.md meeting folders. If you keep several libraries, choose their parent; each custom-named folder only needs meetings/YYYY-MM/*.md inside. The website does not change your Mac; the final folder choice happens in COS Control. You can also skip this step and use new standalone G2 recordings.
Never babysit the server again. Have your COS create a /cos-glasses skill — ask it: "add the /cos-glasses skill from the Starter Kit." Then /cos-glasses starts the server, health-checks it, keeps it on the latest release, and troubleshoots connection issues for you. Grab it at skills/cos-glasses.md.
Pick up where the glasses left off. Add the /glasses-day skill and your COS pulls the day's glasses questions and answers into your desk session — so anything you asked on the go becomes something you can act on. Grab it at skills/glasses-day.md.
Nothing here blocks setup — the glasses run great on the defaults. Tune when you're ready; every pick renders a personalized checklist at the bottom.
How will you use them?
Pick all that apply. Everything below tunes to your answer.
Pick your default brain
A soft default, not a commitment — every model stays available per query, by voice or from the toolbar. Opus, Fable, and Sonnet follow Claude Code; GPT Frontier and GPT Balanced follow the newest capable Codex generation automatically.
No per-token cost on chat. Chat runs on the Claude Code, Codex or Cursor plans you already have. Install more than one and every brain stays available. The server uses whichever is present. Voice is separate; see Compute below.
How much can it touch? On the Claude brains COS runs with full tool access by default. It can read and write files and run commands on the server Mac without prompting you. That is what makes the glasses useful for real work. Prefer a tighter posture? Set COS_CLAUDE_TRUST_MODE=allowlist in the server environment before you launch. The query keeps web search and read-only access to your workspace, while shell, edits, and writes are denied. Needs server 6.41.0 or newer. Earlier servers denied workspace reads too, so a hardened install answered "I don't have access to your workspace files." Either way COS instructs the model to treat web pages, files, and transcripts as data, never as instructions.
Want a local model too? Install Ollama on the server Mac and pull a model. COS detects it and offers it automatically as a local option beside the brains above, and the model runs entirely on your Mac. Optional: with no Ollama installed there is nothing to configure.
Who is it working for?
Set the name of the person COS serves. It personalizes answers and the Knowledge graph’s starting point. You can change it in COS Control → Memories → Memory settings → Owner name. This is separate from the Mac that indexes your documents.
This directly improves transcription. COS feeds these spellings to the decoder. Factory examples are ignored, so an untouched profile can no longer bias Whisper toward literal placeholders such as NameOne or YourCompany.
What context should it see?
Wire the sources you live in. We pre-select what fits your use cases. Adjust freely.
Your role is not your folder structure. Executive, marketer, engineer, product lead, people lead, attorney, chief of staff, clinician, or something else: the Blueprint personalizes how COS works, never what your folders must be called. For the easiest setup, choose the folder that directly contains YYYY-MM/*.md. Organize several libraries only if you already work that way; their names are entirely yours.
What should it remember?
Two stores, both plain markdown on your own machine, both readable from the lens.
Memory
Individual notes worth keeping: a decision and why, a correction you had to make twice,
a fact about a person. One file per note. On the glasses you browse them by type and
summary, and double-tap one to ask a follow-up grounded in that exact record.
memory/2026-08-09-pricing-call.md
Threads
Work that spans weeks: a launch, a hire, a renewal. One file per thread, appended as it
moves, so the whole arc stays in one place instead of scattered across meetings.
threads/website-rebuild.md
No database required. Since server 6.22.0 a folder of markdown
is a complete setup. Any nesting, any filename, front matter optional. A symlink is followed, so
notes that already live somewhere else can stay there — at any depth on
6.22.1, top level only on 6.22.0. Add a Python bridge later and the same
files become what it indexes — nothing to migrate, because the files were always the source.
How do you want to start?
Where the notes go. Pick the folder in COS Control and it shows you the resolved path, so you always know where a note you wrote will land.
Where does it run, and how does voice work?
The server runs on your Mac. Your keys, your machine. Pick how voice is transcribed.
Live transcription tier
Spoken replies are separate from transcription. The server provides Local (Kokoro), Local-first, and OpenAI speech engines. Explicit Local fails closed and never calls OpenAI. Local-first can fall back only after a local failure and only when your own OpenAI key and budget are configured. Check tts_local.ready in /api/health.
Optional dictation cleanup. Settings, Voice, Polish model offers Haiku (default), Sonnet or Luna; choose Sonnet for the newest polish, the meaning check and Your style. Haiku and Sonnet use Claude CLI; Luna (GPT-5.6 Luna Fast, since companion 6.10.573) uses Cursor CLI and needs server 6.61.5 and Cursor signed in on your Mac. This choice is separate from the local transcription tier below. Read the dictation guide.
Balanced is the recommended setup. Small.en produces provisional prompt words quickly, Large-v3-Turbo commits the authoritative live transcript, and Large-v3 polishes saved work. Max is opt-in and reuses the existing Large-v3 worker for live commit. A missing Max model falls back visibly to Turbo instead of breaking transcription.
Phone to Mac: connect both over a secure mesh (Tailscale recommended) so the glasses reach your server from anywhere. The setup below covers it.
Photos stay local: install ffmpeg on the Mac for normalized phone uploads, private answer-image galleries, and exact 288×144 G2 previews. Images never need a COS-hosted cloud.
Lens images are manual and off by default. Turn them on from the phone companion. Photo messages end with a cover page; a deliberate two-tap confirmation opens the image. Meetings and microphone-critical states always win.
Your COS Glasses, ready to set up
Make your picks above and your personalized setup appears here.
ModelSonnet (default)
VoiceLocal whisper (free)
Context wired·
Memory and threadsNew folders
1 · Start COS on your Mac
Open COS Control, connect your AI and choose Get started. For optional local voice afterward, run Guided setup and choose Balanced.
Manual terminal alternative (requires Node.js)
$ npx --yes @gotcos/glasses-server@latest --setup-transcription --transcription-tier balancedclick to copy
The glasses app installs from the Even Hub on your iPhone. See Add your glasses above.
Even G2 smart glasses paired with the Even Realities app
Claude Code, Codex CLI or Cursor Agent on your Mac. One is enough. The Codex Mac app is a direct-download starting point. Sign in, return to COS and choose Check again. Claude Desktop alone is not Claude Code.
Local voice sets up inside COS Control. Open Activity, Settings, Setup guide, then Local voice. COS downloads and verifies its own Whisper tools and models without Homebrew. An existing transcription tier is preserved. Separate optional media features may need additional dependencies.
Node.js 20.11+ is needed only for the manual terminal installation below. Control includes its own runtime.
COS Control (recommended) — the Mac menu bar app that installs and runs the server for you, launches at login, and updates and rolls back safely. macOS 14 or later, Apple Silicon. Download
ffmpeg for phone and answer images — brew install ffmpeg
Tailscale (recommended) — a secure mesh so your phone reaches the server on your Mac. Download
Why Tailscale? Your glasses app on the phone needs to reach the server on your Mac. Tailscale gives both a stable IP that works from anywhere — no port forwarding, no firewall hassle.
Start the COS Glasses server
Runs on your own Mac, as a background service under COS Control or in a terminal you keep open.
No terminal: COS Control.Download COS Control, move it into Applications, open it, connect your AI provider and choose Get started. It installs this same server, starts it, and keeps it running at login; Checks, safe restart, update and rollback live in the menu bar. Skip the command below, and use Copy pairing token in step 4. Already running the server in a terminal? Stop it with Ctrl-C first; Control refuses to take over a process it does not own.
Or in the terminal:
$ npx --yes @gotcos/glasses-server@latestclick to copy
Voice runs locally. Mac whisper.cpp remains the authoritative meeting engine and costs zero per minute. Install once: brew install whisper-cpp. Since COS Glasses 6.8.336, you can also choose on-phone Moonshine Tiny or Base for rolling Message and Meeting preview. Text forms and may revise while you speak; the shared glossary + AI finalizer cleans settled phrases, while speaker-attributed Large-v3 remains canonical for meetings. This requires server 6.27.2 or newer. Cloud fallback stays off unless the server operator explicitly enables it with COS_OPENAI_WHISPER_FALLBACK=1 and configures a key.
Running the full COS? Add the /cos-glasses skill so your agent starts the server, health-checks it, keeps it on the latest release, and troubleshoots for you — ask your COS to "add the /cos-glasses skill from the Starter Kit" (skills/cos-glasses.md).
Connect your devices
Install Tailscale on your Mac and iPhone; sign in with the same account on both.
Open Tailscale on your Mac and note its IP (starts with 100.).
Same WiFi? You can use your Mac's local IP instead — Tailscale is just more reliable across networks.
Install COS Glasses on the Even Hub
Even Hub lists COS Glasses 6.11.673. The current companion pack, 6.10.654, is in the Glasses Hub, and the guide describes it. Before field use, read the offline storage limits. In the companion, Views then Review meetings on phone opens meeting and speaker review.
Open the Even Realities app on your iPhone.
Go to Even Hub, search "COS Glasses", install, and open it.
Connect and go
Enter your Mac's Tailscale IP and paste the API token: the server terminal prints it, or click Copy pairing token in COS Control (60 seconds on the clipboard).
Leave the server running, in the terminal or under COS Control, then tap Connect.
Have a COS username? Tap "I have a COS username" — your server details resolve automatically, no IP or token needed.
Switch models anytime: open Settings, choose Default chat model, tap the toolbar model button, or say "switch to GPT Frontier."
Troubleshooting
Full Mac troubleshooting: every COS Control fix is in the Mac guide.
Dictation only copies, though Accessibility shows COS Control on: macOS kept an old entry. In System Settings, Privacy & Security, Accessibility, select COS Control, remove it with the minus button, then add it back with plus and switch it on. COS Control Settings, Pet and appearance, Reset and add again does the same.
COS Control missing from Screen & System Audio Recording: macOS lists it only after COS asks. Start one Mac recording with All Mac audio and choose Allow, or click plus under System Audio Recording Only and choose COS Control.
"Cannot reach server" — confirm both devices are on Tailscale (or the same WiFi) and the server is still running (the terminal window, or the COS Control menu bar item).
npm EACCES / root-owned cache — do not rerun with sudo or recursively change system ownership. Use npm_config_cache="$HOME/.cos-glasses/npm-cache" npx --yes @gotcos/glasses-server@latest. Server 6.12.2+ does not run a second install inside npm's temporary cache.
@latest launched an older version — compare /api/health with npm view @gotcos/glasses-server dist-tags.latest, then restart with npm_config_prefer_online=true npm_config_cache="$HOME/.cos-glasses/npm-cache" npx --yes @gotcos/glasses-server@latest.
"Codex not available" — GPT Frontier/Balanced need the local Codex CLI on the server Mac; run codex --version, then codex login.
Transcription unavailable — run brew install whisper-cpp for free local transcription. Cloud fallback remains off unless an administrator sets both COS_OPENAI_WHISPER_FALLBACK=1 and OPENAI_API_KEY.
Local spoken replies unavailable — on Apple silicon run brew install python@3.12 ffmpeg espeak-ng, restart COS, and allow first-run Kokoro provisioning to finish. Confirm tts_local.ready in /api/health. Explicit Local fails closed; choose OpenAI only if you intend to use your key.
Photos unavailable — run brew install ffmpeg, restart with npx --yes @gotcos/glasses-server@latest, and confirm Lens images is on before testing outside a meeting.
Server disconnects — it auto-reconnects; if persistent, restart with npx --yes @gotcos/glasses-server@latest.
Build your COS Glasses.
Your Even G2, running as a chief of staff on the lens. The context you have already built, now it follows you off the screen.
No slide deck. No black box. You own it, you do not rent it.
REC0:12 ★1 100%
[Priya] if we shift budget to the comparison pages we can hold CPA under target through July.
[You] Lock that in. Flag it in the recap as a decision.
[Marcus] I will have the brief ready Thursday morning.
[Priya] And let us pull the Q3 numbers first.
Double-tap ★ bookmark ↓ end
It works the way you do.
◈ Msg [O] #411 Pg 1/1 9:16a 9/4/26 82%
? What changed for the design review?
─────
→ The design review moved to 10:00. Bring the revised control states and the mobile navigation pass.
The open decision is whether the setup path stays inside Docs or moves into the guided wizard.
Dana owns the navigation review. Sam will confirm the final setup copy before the meeting.
Brief me before the call.
How it works
Numbered, ranked, on the lens. Walk in already knowing the three things that matter, read straight from your meetings and tasks.
◈ Msg ■□□□ LISTEN · [O●] Tap to 82%
Listening...
Speak your message.
Say it once, hands-free.
How it works
Dictate a long prompt or reply by voice. With on-phone Moonshine, text forms and revises while you speak, then the existing finalizer cleans the settled draft. Review it, edit by voice, or re-record before a single word is sent.
■■□□ REC 12:08 ★1 82%
[Maya] We can ship the pilot Friday.
[Sam] The data import needs one day.
[Maya] Then Friday holds.
~ I will check the final rollout notes
Follow the meeting live.
How it works
Fast Moonshine preview can appear while you speak, then speaker-attributed Large-v3 replaces it as the canonical transcript. Takeaways and action items wait for you afterward, right from the glasses.
Say it once. Send it clean.
Dictate a long prompt or reply by voice. Moonshine Tiny or Base can form and revise the text on the lens as you speak; the shared finalizer cleans the settled draft before review. No keyboard required.
MESSAGE · COS [O●] 100%
Listening…
Tap to finish
In your control.
Confirm, edit, or send with a tap. The HUD is there when you need it and gone when you do not. Never a phone, never a screen between you and the room.