Sea Shell

Local-first speech-to-text for audio, video, live microphone + system-audio sessions, speaker diarization, subtitles, and a durable transcript library on macOS.

Sea Shell uses whisper.cpp with Metal acceleration. File and live transcription stay on your machine by default; exact-model cloud drafts/finals require explicit upload consent. Optional speaker diarization needs a Hugging Face token for its first gated model download; inference remains local afterward.

What it does

Transcribes WAV, MP3, FLAC, OGG, Opus, M4A, AAC, MP4, MOV, M4V, MKV, and WebM when the installed FFmpeg build supports their codecs.
Extracts audio streams from video and prepares deterministic 16 kHz PCM for Whisper.
Produces plain text, timestamped text, speaker-aware text, JSON, SRT, and WebVTT without rerunning transcription for each rendering.
Saves successful file and live transcripts to a readable local folder.
Lets you rename anonymous diarization clusters such as SPEAKER_00 to human names without retranscribing.
Can conservatively identify clusters from meeting rosters, timestamped active-speaker observations, self-introductions, and explicit handoffs.
Can turn any saved transcript into an optional meeting artifact with notes, evidence-linked analysis, cited chat, and friendly Markdown/JSON/subtitle files.
Keeps the terminal UI transcript-first, with an on-demand history drawer for saved recordings, search, speaker labels, timestamps, and exports.
Keeps command output clean for shell pipelines and AI agents.
Advertises its local batch transcription through a versioned capability manifest so an installed Humain engine can discover and invoke it without making either product depend on the other.
Captures microphone and macOS system audio concurrently for live calls, labels the sources separately, skips silent chunks, and suppresses strong time-overlapping speaker-playback duplicates from the microphone transcript.
Keeps live ASR bounded: one owned warm local worker, a measured machine-local profile, and optional consented cloud/adaptive routing through Humain.
Can watch low-cost macOS process-audio signals in the background, start and stop durable meeting capture automatically, and defer expensive inference until the meeting ends.

Requirements

macOS; Apple Silicon is recommended. Live system audio requires macOS 14.2+
Bun
FFmpeg and ffprobe for media inspection and audio extraction
SoX for live microphone capture
CMake and Git for building whisper.cpp

Sea Shell's installer can add the Homebrew packages it needs. To install them yourself instead:

brew install ffmpeg sox cmake git

Speaker diarization additionally needs Python 3.10+ (3.12 recommended) and the Python packages described under Speaker diarization. Meeting intelligence optionally uses the separate Humain engine; ordinary capture, transcription, diarization, history, and exports do not require it.

Installation

On a Mac with Homebrew, this is the complete first-install command:

/bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/stupart/seashell/main/bootstrap.sh)"

The bootstrap clones Sea Shell into ~/.local/share/seashell and runs the installer. The installer adds missing Bun/Homebrew dependencies, builds whisper.cpp with Metal, downloads the Whisper large-v3-turbo and Silero VAD models, and creates a global seashell command.

There is no separate setup step. On a true first install, Sea Shell writes local-only defaults, saves transcripts in ~/Documents/Sea Shell/Transcripts, and starts its lightweight meeting watcher whenever you log into your Mac. Reinstalling or updating preserves the existing config and launch-at-login choice byte-for-byte. Set SEASHELL_SKIP_AUTOSTART=1 on the install command if you prefer to launch Sea Shell manually; SEASHELL_SKIP_FIRST_RUN=1 suppresses all automatic first-run configuration.

macOS itself still asks for Microphone, Screen & System Audio Recording, and optional Calendar access when each capability is first used. Sea Shell cannot and should not bypass those system dialogs. Local file/live transcription does not require an API key, Humain, or a cloud account.

Updating

Git-based installations can update in place; no uninstall is needed:

seashell update --check
seashell update

The updater fetches the current branch's configured remote, permits only a clean fast-forward, and then runs bun install --frozen-lockfile. It never merges divergent history or discards tracked changes. --json makes either command machine-readable. A branch must exist on the remote before it can be updated this way.

Quick start

Open the live transcription and library TUI:

seashell

Transcribe audio or video while preserving the original plain-text shortcut:

seashell interview.m4a
seashell product-demo.mp4
seashell transcribe meeting.mov --timestamps
seashell transcribe meeting.mov --speakers
seashell transcribe meeting.mov --timestamps --speakers

Create subtitle or structured output:

seashell transcribe demo.mp4 --format srt --output demo.srt
seashell transcribe demo.mp4 --format vtt > demo.vtt
seashell transcribe meeting.mp4 --speakers --format json > meeting.json
seashell transcribe meeting.mp4 --speakers --format srt > meeting.srt

Create and enrich a saved meeting:

seashell meeting setup --backend codex --model <exact-model> --mode hybrid
seashell meeting create <transcript-id>
seashell meeting enrich <transcript-id>
seashell meeting show <transcript-id>
seashell meeting chat <transcript-id> "What did we decide?"

Automatic meeting capture is already on after a normal first install. Inspect, disable, or re-enable it with:

seashell meeting autostart status
seashell meeting autostart disable
seashell meeting autostart enable

This installs a per-user macOS LaunchAgent for the Sea Shell watcher; Humain is not a daemon and is invoked only when optional meeting intelligence is configured. Advanced policies remain configurable through seashell meeting setup; ordinary users do not need to run it.

Inspect what Sea Shell can contribute to Humain or another compatible host:

seashell capabilities --json

Progress and save locations are written to stderr. Transcript content is the only data written to stdout, so piping remains reliable.

Automatic meetings and Google Meet

Sea Shell detects which macOS process is actively using audio input. A dedicated meeting app such as Zoom, Teams, Webex, or FaceTime starts automatically after two confirming polls. Browser audio from Chrome, Safari, Arc, Edge, Brave, or Firefox also starts automatically when a current Calendar event corroborates it. Browser audio without a matching event asks by default because it could be a voice form, recording site, or another non-meeting use. The TUI accepts M/X; the background watcher posts a notification and accepts seashell meeting consent approve|decline. Calendar data alone never starts recording.

Once started, Sea Shell atomically commits microphone and system-audio WAV chunks on one session clock. The background watcher deliberately keeps Whisper and diarization unloaded during the call. After 20 seconds without the meeting signal, it stops capture quickly and queues final transcription, optional local diarization and attendee-backed speaker labeling, and optional Humain notes. The watcher can re-arm while prior post-processing finishes. If system audio permission fails, useful microphone-only capture continues; a model failure cannot delete already committed audio.

The TUI and background watcher share one per-user lock. Opening Sea Shell while the login watcher owns capture gives a live library view without starting a second recorder. Logs live under ~/Library/Application Support/Sea Shell/Logs. Google Meet participant tiles and active-speaker state are not inspected yet; Calendar attendees, self-identification, explicit handoffs, and supplied timestamp evidence are the current identity sources. Use headphones when possible, and review attribution when laptop-speaker echo or people in the same physical room make sources ambiguous.

Before the meeting, prove both inputs with a disposable five-second check while speaking and playing computer audio:

seashell capture test --seconds 5

The test reports microphone and system signal independently and deletes only its own test recording. During capture, the footer shows both meters and the number of safely committed chunks.

Run one cheap detection probe without recording a full meeting:

seashell meeting watch --once --json

Live performance and routing

Capture is durable before inference. CoreAudio writes only to a preallocated bounded handoff; conversion, disk durability, hashing, and transcription happen off its real-time callback. The local draft queue is bounded and uses one Sea Shell-owned warm Whisper server, which shuts down after idle time or quit. It never attaches to an unrelated server already running on the computer.

Local is the default. Optional cloud and adaptive modes require Humain, an exact OpenRouter STT model, and explicit upload consent in the Sea Shell config. The canonical final route is pinned separately, so adaptive cloud drafts do not silently turn the saved transcript into a cloud result. See docs/live-performance-routing-0.1.md for the config and clock contract.

Benchmark the exact local model on this computer with a representative 16 kHz mono WAV:

bun run benchmark:live-asr -- ./sample.wav

Terminal UI

Sea Shell opens on the same simple, transcript-first screen used for live capture. Press H (or Tab) to slide open a history drawer with Live at the top and saved transcripts below it. Moving through history previews each saved transcript in the main panel; Enter selects it and closes the drawer.

Timestamps and speaker labels are visible by default when the transcript has them. T and S hide or show those presentation layers without changing the stored transcript. At 72 columns and wider, history and the transcript remain side by side. On narrower terminals, the drawer temporarily uses the full body until it is closed.

Key	Action
`H` or `Tab`	Open or close transcript history
`↑`/`↓` or `J`/`K`	Preview history items when the drawer is open; otherwise scroll the transcript
`Enter`	Open the selected history item and close the drawer; pause/resume in live view
`Esc`	Close history, a prompt, or help; otherwise quit
`/`	Open history and search saved titles, source names, speaker names, and transcript text
`L`	Return to live transcription
`Space`	Pause/resume live microphone + system-audio capture
`F`	Import audio or video
`Shift+F`	Import and run speaker diarization
`M`	Mark the current transcript as a meeting; attach a pending calendar suggestion
`1`–`4`	Open meeting Notes, Transcript, Analysis, or Chat
`G`	Finish a live meeting: stop capture, run final ASR, save raw tracks, then run configured enrichment
`A`	Ask an evidence-cited question about the current meeting
`T`	Toggle timestamp presentation
`S`	Toggle speaker presentation
`[` / `]`	Select a speaker label
`R`	Rename the selected speaker
`E`	Export as SRT, WebVTT, text, or JSON
`C`	Copy the current rendering
`O`	Open the transcript folder in Finder
`D`	Move a saved transcript to recoverable `_Trash` after confirmation
`Delete`	Start a fresh live transcript
`?`	Show contextual keyboard help
`Q`	Quit from any normal view

The main shortcut row stays intentionally small; press ? for the complete key map.

Drag-and-drop also accepts absolute audio or video paths. Live microphone and system capture pause while an import runs and resume afterward.

Transcript library

Successful transcriptions save by default to:

~/Documents/Sea Shell/Transcripts/
└── 2026-08-06/
    └── product-interview--20260806143000-a1b2c3d4/
        ├── transcript.json
        ├── transcript.txt
        ├── transcript.srt   # after SRT export
        └── transcript.vtt   # after WebVTT export

transcript.json is authoritative. Text and subtitle files are derived views. The original media is never copied into the library; its local path and media metadata are recorded. Listings are rebuilt by scanning transcript folders, so there is no irreplaceable database or index.

Use --no-save for an ephemeral command or --library-dir to override the destination:

seashell talk.mp3 --no-save
seashell talk.mp3 --library-dir ./project-transcripts

Library commands:

seashell library list
seashell library list --json
seashell library search "launch notes" --json
seashell library show <id> --timestamps --speakers
seashell library show <id> --format json
seashell library export <id> --format srt
seashell library speakers <id> set SPEAKER_00 "Tyler"
seashell library open <id>
seashell library trash <id> --confirm

Trash is recoverable inside <library>/_Trash; Sea Shell does not permanently delete records from its TUI or CLI.

Meeting mode

A meeting is a companion artifact, not a replacement transcript. Marking a transcript creates meeting.json beside the authoritative transcript.json. The normal Sea Shell screen remains unchanged for ordinary recordings. Meeting tabs appear only when the selected history item has a meeting artifact.

Sea Shell chooses the model route for each product job; Humain pins and executes that exact instruction. A shared route remains the simplest setup and is used for observer, reconciliation, and chat unless a role-specific route overrides it. Settings store model selection and workflow preferences, never an API key:

# ChatGPT subscription through the local Codex harness
seashell meeting setup \
  --backend codex \
  --model <exact-codex-model> \
  --mode hybrid \
  --calendar ask

# Or a metered model through OpenRouter
seashell meeting setup \
  --backend openrouter \
  --model <callable-openrouter-model-id> \
  --mode hybrid

# Or use a cheap observer and stronger final/chat models
seashell meeting setup \
  --observer-backend openrouter \
  --observer-model <cheap-fast-model> \
  --reconciliation-backend codex \
  --reconciliation-model <strong-exact-model> \
  --chat-backend codex \
  --chat-model <balanced-exact-model> \
  --mode hybrid

Humain must be installed as humain, or HUMAIN_CLI can point to its built dist/cli.js. Codex and Claude Code routes use Humain's verified subscription adapters. OpenRouter uses the API key configured in Humain and keeps exact model, token, and cost provenance in its private run store.

Humain is optional in both directions. Sea Shell without Humain still records, transcribes, diarizes, saves, and exports locally. Humain without Sea Shell continues to run its other capabilities. When both are installed, humain setup discovers transcription.seashell.local, and Humain users can run local audio/video transcription through the engine's SDK or CLI.

For consented cloud transcription, add a transcription object to:

~/Library/Application Support/Sea Shell/config.json

The complete Local/Cloud/Adaptive example is in docs/live-performance-routing-0.1.md.

Google Meet status

The current build imports Meet recordings, captures live microphone plus macOS system audio, and detects a browser that is actively using audio input. A current Calendar event can corroborate that browser signal and supply the title and attendee roster. It does not yet read Meet participant tiles or active-speaker state.

The planned stages are deliberately separate:

Works with Meet: shipped as local mic/system capture on one durable session clock, with independently recoverable raw tracks and a full-track final transcription pass.
Detects Meet: shipped process-audio detection. A calendar-corroborated browser call starts automatically by default; browser audio without that evidence asks unless the user explicitly changes its policy.
Integrates with Meet: an optional browser adapter contributes timestamped participant/active-speaker evidence. It is fallible enrichment, not a capture dependency.

Calendar attendees, deterministic mic=You, diarization clusters, self-identification, corrections, and optional voice profiles provide identity evidence. Weak or conflicting evidence keeps the stable anonymous speaker ID.

The three enrichment modes share one artifact contract:

streaming observes only newly committed transcript segments plus a small overlap and publishes provisional claims.
post-session reads the complete frozen transcript once.
hybrid runs the incremental observer and then reconciles the complete meeting, resolving late corrections and reversals before publishing final notes.

Every model claim must cite stable transcript segment IDs. Invalid citations are rejected. Observer runs are bounded by a durable cursor and maximum run count, so a growing transcript is not resent in full on every iteration. Failures leave the base transcript and exports intact.

Interrupted-capture recovery

Every live chunk is committed before transcription. A crash or forced quit can therefore lose only an uncommitted in-memory buffer, not the already recorded meeting. On the next launch Sea Shell reports recoverable sessions. Inspect and finalize one with:

seashell capture list
seashell capture show <session-id> --json
seashell capture finalize <session-id>

Normal Q saves the current transcript and attaches the raw-track bundle. Automatic meetings stop and finalize after the configured grace period. The manual fallback remains: press M to mark/approve a meeting and G to finish it. Finalization waits for queued work, rebuilds the transcript from complete tracks, attaches the raw bundle, and then asks Humain for notes and analysis if routes are configured. If Humain is missing or unconfigured, the capture and final transcript still save.

The full artifact bundle is readable without Sea Shell:

<meeting-folder>/
├── transcript.json
├── transcript.txt
├── meeting.json
├── transcript.md
├── transcript.srt
├── transcript.vtt
├── overlays/
│   ├── provisional.jsonl
│   └── final.json
├── enriched/
│   ├── transcript.json
│   ├── transcript.md
│   ├── transcript.srt
│   └── transcript.vtt
├── documents/
│   ├── summary.md
│   ├── decisions.md
│   ├── actions.md
│   ├── notes.md
│   └── resources.md
└── .humain/                 # private durable run receipts and evidence

Calendar suggestions

Calendar access is read-only and opt-in. --calendar ask surfaces the current or next macOS Calendar event and may corroborate a browser audio signal. all attaches matching events automatically; off disables the connector. The first enabled read can trigger the normal macOS Calendar permission prompt. Calendar alone never starts recording, and automatic model use still requires an exact configured route.

Inspect the read-only event window without opening the TUI:

seashell meeting calendar --json

Canonical transcript schema

Every record retains timestamps whether or not the selected text view displays them. Speaker IDs remain stable, while labels are editable:

{
  "schemaVersion": 1,
  "id": "20260806143000-a1b2c3d4",
  "title": "Product interview",
  "createdAt": "2026-08-06T14:30:00.000Z",
  "updatedAt": "2026-08-06T14:32:10.000Z",
  "source": {
    "path": "/Users/me/Movies/interview.mp4",
    "filename": "interview.mp4",
    "duration": 130.4,
    "format": "mov,mp4,m4a,3gp,3g2,mj2",
    "audioStreamIndex": 1,
    "channels": 2
  },
  "transcript": [
    {
      "start": 0.42,
      "end": 2.18,
      "speaker": "SPEAKER_00",
      "text": "Let's ship it."
    }
  ],
  "speakers": [
    { "id": "SPEAKER_00", "label": "Tyler" }
  ]
}

Non-diarized segments omit speaker. Optional summary, decisions, and action_items fields remain available for provider-neutral enrichment.

Media preparation

Sea Shell uses ffprobe to enumerate audio streams and reject media without audio. FFmpeg selects one stream, ignores video, decodes its codec, resamples it, and writes 16 kHz signed PCM WAV for Whisper. This is not loudness normalization.

Ordinary transcription produces mono PCM. Speaker diarization preserves source channels, and --channel-roles can assign explicit channel identity. When a container has multiple audio tracks, inspect them with ffprobe and select one by its absolute stream index:

ffprobe -v error -select_streams a -show_streams movie.mkv
seashell transcribe movie.mkv --audio-stream 3

Speaker diarization

Sea Shell uses the local pyannote/speaker-diarization-community-1 pipeline. Diarization creates recording-local clusters; it does not inherently know human identities. Rename those clusters later through the TUI or library CLI.

One-time setup:

brew install [email protected] ffmpeg
python3.12 -m venv .venv-diarization
source .venv-diarization/bin/activate
python -m pip install -r scripts/requirements-diarization.txt

Then accept the Community-1 model conditions, create a Hugging Face read token, and use it for the first model download:

export HF_TOKEN=hf_your_read_token
seashell transcribe meeting.m4a --speakers --format json

Later runs use the Hugging Face cache. HF_HUB_OFFLINE=1 enforces cached-only operation, and PYANNOTE_METRICS_ENABLED=0 disables pyannote telemetry. The experimental SEASHELL_DIARIZATION_DEVICE=mps setting requests MPS; CPU is the documented macOS default.

When this local capability is ready, the live-meeting finalizer automatically separates the completed system-audio track into stable REMOTE_* speaker clusters. Without it, tomorrow-safe capture still uses the honest source labels Microphone and System audio; recording, timestamps, recovery, and Humain notes do not depend on pyannote.

Speaker count hints remain available:

seashell transcribe meeting.wav --speakers --num-speakers 3
seashell transcribe meeting.wav --speakers --min-speakers 2 --max-speakers 5

The legacy command remains valid and defaults to JSON:

seashell --diarize meeting.m4a

Speaker identification evidence

Diarization discovers consistent recording-local voices such as SPEAKER_00; identity is a separate pass. Sea Shell can conservatively match those voices to a meeting roster using timestamped active-speaker observations, self-identification (for example, “I'm Ada”), and explicit handoffs (for example, “Grace, what do you think?”).

Supply a JSON sidecar when transcribing:

seashell transcribe meeting.mp4 \
  --speakers \
  --speaker-evidence meeting-speakers.json \
  --timestamps

{
  "attendees": [
    { "name": "Ada Lovelace", "email": "[email protected]" },
    { "name": "Grace Hopper", "email": "[email protected]" }
  ],
  "activeSpeakers": [
    { "capturedAt": 12.4, "name": "Ada Lovelace", "source": "google-meet" },
    { "capturedAt": 18.7, "name": "Grace Hopper", "source": "google-meet" }
  ]
}

capturedAt is seconds from the beginning of the selected recording audio—the same clock used by transcript timestamps. A browser or screen adapter must currently produce these observations; the built-in pass does not inspect raw screenshot pixels. First-name aliases are accepted only when unique in the roster. Conflicting evidence leaves the diarization ID unchanged, and an existing human label is never overwritten.

The default identity pass is local and deterministic. The SpeakerLabeler interface is the opt-in seam for a future local or hosted LLM. A safe LLM implementation should receive short timestamped context windows and the known roster, return structured candidate/evidence/confidence fields, be forbidden from inventing names outside that roster, and preserve “unknown” below a high confidence threshold. Raw audio and screenshots do not need to be sent to the model.

Known channel roles

For a verified two-channel mic/system recording:

seashell transcribe meeting-stereo.wav \
  --speakers \
  --channel-roles local,remote \
  --format json

The first channel is fixed to LOCAL; remote channels are clustered as REMOTE_00, REMOTE_01, and so on. Sea Shell never guesses physical channel order. Verify routing before assigning roles.

Configuration

Library-directory precedence is:

--library-dir
SEASHELL_LIBRARY_DIR
libraryDir in the config file
~/Documents/Sea Shell/Transcripts

The default macOS config path is:

~/Library/Application Support/Sea Shell/config.json

Override that path with SEASHELL_CONFIG. Example:

{
  "libraryDir": "~/Documents/Work Transcripts",
  "saveByDefault": true
}

Meeting intelligence can include an explicit, bounded allow-list of project files. Each file is limited to 512 KiB and the total to 2 MiB; Sea Shell does not scan the containing folder. Their contents may be sent to the configured Humain route, so add only material appropriate for that provider:

seashell meeting setup \
  --context-file /absolute/path/to/BLUEPRINT.md \
  --context-file /absolute/path/to/project-notes.md
seashell meeting setup --clear-context-files

CLI reference for scripts and AI agents

Run seashell --help for the complete command summary and seashell doctor --json for machine-readable readiness checks.

Operational guarantees:

stdout contains only requested transcript or JSON data;
progress, save locations, and errors go to stderr;
non-interactive commands never prompt;
paths are passed to subprocesses as argument arrays, not interpolated shell commands;
JSON, SRT, and WebVTT accept exactly one source file;
multiple files remain supported for plain-text output;
exit code 0 means success and 1 means validation, dependency, media, or processing failure; signal exits use the standard 130/143 codes.

Example agent workflow:

seashell doctor --json
seashell update --check --json
seashell transcribe input.mp4 --format json --no-save --quiet > transcript.json
seashell library list --json
seashell library show <id> --format json
seashell meeting show <id> --json

Privacy

Audio, video, durable live-capture chunks, transcripts, and speaker inference stay local.
Roster and active-speaker evidence stays local in the built-in identity pass.
Meeting enrichment sends only the selected transcript and explicitly supplied context to the configured Humain route. Codex/Claude Code subscription and OpenRouter routes are remote; use meeting mode only when that data sharing is appropriate.
Newly written transcript, meeting, capture, config, and LaunchAgent log folders use private per-user permissions (0700 directories and 0600 files), subject to the security of the macOS account and disk.
Source media is not copied into the transcript library.
Core transcription needs no cloud account or API key.
Speaker diarization contacts Hugging Face only when model files must be downloaded, unless offline mode is enforced.
Saved JSON contains the original source path by default; use --no-save when path retention is undesirable.

Sea Shell is not represented as HIPAA compliant or certified. See docs/privacy-and-hipaa.md for the current data boundaries and the controls still required for a HIPAA-regulated deployment.

Troubleshooting

Run this first:

seashell doctor

ffprobe or ffmpeg missing: brew install ffmpeg.
No audio stream found: the selected video has no audio track, or its track is not exposed by the container. Inspect it with ffprobe -show_streams.
Wrong language/audio track: use --audio-stream <index>.
whisper.cpp/model missing: rerun ./install.sh.
Metal initialization crashes: Sea Shell automatically retries file and live transcription on CPU. Set SEASHELL_DISABLE_GPU=1 to skip the Metal attempt entirely while diagnosing the local whisper.cpp build.
Speaker setup failure: activate .venv-diarization, verify the pyannote packages, accept the model terms, and provide HF_TOKEN for the first run.
Aggregate channel mismatch: verify the channel count and physical routing before using --channel-roles.
System audio unavailable: run seashell doctor; allow your terminal or Sea Shell in System Settings → Privacy & Security → Screen & System Audio Recording, then fully reopen the app. Set SEASHELL_DISABLE_SYSTEM_AUDIO=1 for an explicit microphone-only session.
Doctor says the helper started but no buffer was observed: CoreAudio taps may stay idle when nothing is playing. Run seashell capture test --seconds 5 while playing computer audio to verify the real signal path.
System audio starts but receives no buffers: verify the macOS output path itself with afplay /System/Library/Sounds/Glass.aiff. If that also fails, reconnect or change the output device before debugging Sea Shell.
Malformed config: validate the JSON at the config path printed above.

Development

bun install
bun run typecheck
bun run test

The standard suite does not download pyannote models. FFmpeg-backed integration tests generate tiny local fixtures when FFmpeg is available.

License

MIT. Optional Community-1 model weights are downloaded separately under CC BY 4.0 and are not bundled with Sea Shell.

Sea Shell is the local-first STT engine behind conch, an open experiment from Blueprint Studio.

Name		Name	Last commit message	Last commit date
.cursor/rules		.cursor/rules
docs		docs
native		native
scripts		scripts
src		src
test		test
.gitignore		.gitignore
CHANGELOG.md		CHANGELOG.md
CLAUDE.md		CLAUDE.md
README.md		README.md
ROADMAP.md		ROADMAP.md
THIRD_PARTY_NOTICES.md		THIRD_PARTY_NOTICES.md
bootstrap.sh		bootstrap.sh
bun.lock		bun.lock
install.sh		install.sh
package.json		package.json
seashell		seashell
tsconfig.json		tsconfig.json

Navigation Menu

Repository files navigation

Sea Shell

What it does

Requirements

Installation

Updating

Quick start

Automatic meetings and Google Meet

Live performance and routing

Terminal UI

Transcript library

Meeting mode

Google Meet status

Interrupted-capture recovery

Calendar suggestions

Canonical transcript schema

Media preparation

Speaker diarization

Speaker identification evidence

Known channel roles

Configuration

CLI reference for scripts and AI agents

Privacy

Troubleshooting

Development

License

About

Releases

Packages

Contributors

Languages

Latest commit

History

Folders and files

Repository files navigation

Sea Shell

What it does

Requirements

Installation

Updating

Quick start

Automatic meetings and Google Meet

Live performance and routing

Terminal UI

Transcript library

Meeting mode

Google Meet status

Interrupted-capture recovery

Calendar suggestions

Canonical transcript schema

Media preparation

Speaker diarization

Speaker identification evidence

Known channel roles

Configuration

CLI reference for scripts and AI agents

Privacy

Troubleshooting

Development

License

About

Topics

Resources

Stars

Watchers

Forks

Releases

Packages

Contributors

Languages