# Peek > Peek is a local, voice-first way for Carbons and Silicons to exchange quick messages on a Mac. A Silicon claims one of eight screen positions, registers a JavaScript drawing, and uses the `peek` CLI to speak, show up to three text or image elements, or ask one question. The Carbon answers by voice, keyboard or click, and the answer returns to the Silicon as a Ting event. Install (macOS 26+): `curl -fsSL https://peek.teamofsilicons.com/install.sh | sh`. CLI only (Linux, Windows): `honeycomb install 'peek'`. Offline docs: `peek docs `. ## Docs - [Peek documentation](https://peek.teamofsilicons.com/docs/markdown/index.md): Peek puts a small glass bubble on a Carbon's Mac screen so a Silicon can speak a sentence, show up to three things, or ask one quick question, without opening a conversation. - [Start here](https://peek.teamofsilicons.com/docs/markdown/start.md): Peek is a local, voice-first way for Carbons and Silicons to exchange quick messages on a Mac. - [Peek for Carbons](https://peek.teamofsilicons.com/docs/markdown/carbon.md): This page is for the human at the Mac. Peek shows bubbles from your Silicons at the edges of your screen, speaks for them, and lets you answer with your voice, your keyboard or a click. - [Peek for Silicons](https://peek.teamofsilicons.com/docs/markdown/silicon.md): This page is for Silicons and the people who write them. It covers what is mandatory, the exact commands, and how answers come back into your flow. Every command here is non-interactive: - [CLI reference](https://peek.teamofsilicons.com/docs/markdown/cli.md): peek is one Rust binary. It is built for agents first: it never prompts, it prints exactly one JSON value with --json, and every error says what failed, why, and the command that fixes it. - [Speak and show](https://peek.teamofsilicons.com/docs/markdown/show.md): peek send --speak says a sentence in your voice; peek send --show puts up to three text or image elements on your bubble's information arc. Use them together for a glanceable update: - [Ask a question](https://peek.teamofsilicons.com/docs/markdown/ask.md): peek send --ask puts one question on the Carbon's screen and returns immediately. The Carbon answers by click, keyboard or voice, and the answer comes back to you as a peek.ask.answered Ting event… - [Drawing the visual](https://peek.teamofsilicons.com/docs/markdown/drawing.md): Every bubble has a circle that belongs to its Silicon: the visual. You fill it with a small JavaScript file that peek runs every frame. - [Ting events](https://peek.teamofsilicons.com/docs/markdown/ting.md): Everything the Carbon does in response to a Silicon (an answer, a dismissal, a message) comes back to that Silicon as a Ting event. - [IAM and sessions](https://peek.teamofsilicons.com/docs/markdown/iam.md): peek signs Silicons in with IAM short-lived tokens only. It never asks for a password or a Silicon token, it stores each Silicon's session in that Silicon's own home, and its backend keeps no IAM… - [Testing environments](https://peek.teamofsilicons.com/docs/markdown/testing.md): peek supports IAM testing environments: isolated worlds with their own identities, orgs, Ting types and data, driven by peek's test app secret. - [Telemetry](https://peek.teamofsilicons.com/docs/markdown/telemetry.md): peek records operational telemetry by default, so failures can be traced from the CLI through the helper and the backend. It never records what anyone said, showed, asked or answered. - [Privacy](https://peek.teamofsilicons.com/docs/markdown/privacy.md): peek is a local app. Bubbles, history, recordings and caches stay on the Mac. What leaves the Mac, leaves for one reason each: - [Platforms](https://peek.teamofsilicons.com/docs/markdown/platforms.md): Bubbles need a Mac: Peek.app is a native macOS 26+ app with Liquid Glass. The peek CLI, however, is the same Rust binary on every platform Honeycomb supports, so a Silicon on Linux or Windows can… - [Development](https://peek.teamofsilicons.com/docs/markdown/development.md): peek is open source: https://github.com/teamofsilicons/silicon-peek. This page explains how the pieces fit, how to build and test each one, the local protocol between them, and how to contribute a… - [Versioning and compatibility](https://peek.teamofsilicons.com/docs/markdown/versioning.md): peek runs as many pieces that update on their own schedules: a CLI copy in every Silicon home, one Peek.app and helper per Mac, one backend, and the Stemcell flows that consume its events. - [Troubleshooting](https://peek.teamofsilicons.com/docs/markdown/troubleshooting.md): Start with peek doctor. It checks everything peek depends on and prints the exact fix for anything that is wrong. Then find your symptom or error code below. ## Optional - [Source code](https://github.com/teamofsilicons/silicon-peek): the Rust CLI, daemon and backend, the macOS app and this site. - [Installer](https://peek.teamofsilicons.com/install.sh): the one-line technical setup script.