Role Workflow · Engineering & Tech

Private Mac notes for engineering managers

Sovereign 1-on-1 logs, team coaching dossiers, and technical decision records in plain Markdown on macOS.

Verified WorkflowEvidence in codebase: main/meeting/meeting-detector.ts, shared/summary-templates.ts (as of 2026-10-03)macOS 14.2+, local-first Apple Silicon execution

Problem

Critical challenges for engineering managers

  • Awkward AI recording bots intimidate direct reports during delicate 1-on-1 career conversations
  • Performance observations and compensation notes end up scattered across disjointed SaaS portals
  • Cloud transcription vendors store confidential personnel feedback on external corporate infrastructure

Response

How Oyma supports engineering managers

  • Capture 1-on-1 dialogue silently via ScreenCaptureKit without a virtual bot chilling candor
  • Organize direct report dossiers into an interconnected Obsidian-compatible Markdown vault
  • Execute Whisper transcription 100% on-device with zero data egress outside your Mac

Engineering management is fundamentally an exercise in high-context human relationships combined with rigorous organizational accountability. Between weekly 1-on-1s with direct reports, sprint retrospectives, quarterly promotion reviews, and cross-functional architecture committees, an engineering manager spends upwards of twenty hours every week in spoken conversation.

Yet documenting these discussions creates an intense operational conflict:

If you don’t take thorough notes, critical career commitments are forgotten, subtle signs of developer burnout go unnoticed, and performance reviews turn into subjective guesswork. But if you invite a typical cloud AI recording bot into a 1-on-1, you destroy psychological safety. Direct reports immediately become guarded, self-censor their frustrations, and hesitate to speak candidly about team friction or career goals.

Oyma resolves this leadership dilemma on macOS. By leveraging Apple’s ScreenCaptureKit framework, Oyma captures and transcribes 1-on-1 conversations silently on Apple Silicon without dispatching an uninvited bot into the room. Spoken dialogue is processed 100% on-device with local Whisper models, generating structured Markdown records that connect seamlessly with your team dossiers.

The psychological safety crisis in engineering 1-on-1s

A great 1-on-1 is not a status update; it is a confidential sanctuary for growth, feedback, and candid problem-solving. Deploying conventional AI meeting utilities into this sacred space creates immediate failure modes:

  1. The bot chilling effect: When a third-party bot enters the video call roster displaying an "AI Notetaker" banner, direct reports instinctively tense up. They will not confide in you about team dysfunction, compensation anxieties, or personal burnout while a robot is recording them.
  2. Personnel data leaks: Spoken reviews routinely involve sensitive personnel data: underperformance warnings, health emergencies, equity disputes, and confidential re-orgs. Transmitting this raw audio to cloud transcription vendors violates basic employee privacy expectations.
  3. Fragmented employee dossiers: Notes taken across disparate apps (Google Docs, Apple Notes, Slack messages) become impossible to synthesize when annual promotion committee season arrives.
  4. Context switching friction: Trying to type verbatim notes while actively listening forces managers to look away from the camera, signaling disinterest and eroding interpersonal trust.

The engineering manager’s local dossier topology

Oyma replaces scattered cloud notes with an interconnected, private knowledge system centered around your team members:

┌────────────────────────────────────────────────────────────────────────┐
│               ENGINEERING MANAGER KNOWLEDGE GRAPH TOPOLOGY             │
├────────────────────────────────────────────────────────────────────────┤
│                                                                        │
│                      [Teammate: Alex Chen]                             │
│                      teammates/alex-chen.md                            │
│                                ▲                                       │
│          ┌─────────────────────┼─────────────────────┐                 │
│          │                     │                     │                 │
│          ▼                     ▼                     ▼                 │
│   [1-on-1: 2026-09-15]  [1-on-1: 2026-09-29]  [1-on-1: 2026-10-08]     │
│   Sprint goals          Burnout warning       Senior promo review      │
│          │                     │                     │                 │
│          └─────────────────────┼─────────────────────┘                 │
│                                ▼                                       │
│                    [[Promotion Case: Senior]]                          │
│                    promotions/alex-senior-case.md                      │
│                                                                        │
└────────────────────────────────────────────────────────────────────────┘

By leveraging bidirectional [[wikilinks]], each weekly 1-on-1 automatically links back to the individual engineer’s main profile. When drafting annual performance summaries or promotion packets, you simply open the engineer’s file and review their entire chronological progression in seconds.

The 4-step workflow: From spoken conversation to promotion evidence

Here is how an engineering manager operates day-to-day with Oyma:

Step 1: Automated call detection with zero bot overhead

When you open Zoom, Google Meet, or Slack Huddles for your 1-on-1, Oyma‘s CoreAudio detector recognizes the active meeting. A quiet notification appears on your Mac desktop asking if you want to record. No bot joins the call. Your direct report sees only your normal video feed.

Step 2: Unobtrusive active listening

With recording running locally in the background, you can maintain direct eye contact and focus completely on what your engineer is saying. If they mention an important milestone or specific code commit, you can tap a quick bookmark hotkey without taking your attention off the conversation.

Step 3: Local Whisper speech synthesis

The moment you end the call, Oyma‘s on-device Whisper engine transcribes the audio locally using your Mac’s Apple Silicon Neural Engine. It automatically extracts action items, career development points, and key commitments.

Step 4: Vault filing in standard Markdown

The synthesized record writes directly into your local Markdown vault as a clean .md file, immediately ready for cross-linking with your sprint goals and team backlog.

Real-world 1-on-1 note specification

Here is an authentic sample note generated by Oyma for an engineering manager:

---
title: "1-on-1: Alex Chen (Bi-weekly 1-on-1)"
date: 2026-10-08
type: one-on-one
teammate: "[[Alex Chen]]"
role: "Staff Software Engineer"
tags: [one-on-one, engineering, leadership, promotion-track]
---

## Meeting Context & Energy Level
Alex appeared energized following the successful deployment of the new Kafka streaming pipeline. Expressed satisfaction with mentoring junior engineers but flagged creeping context switching from ad-hoc Slack interruptions.

## Career Progression & Objectives
- Progress toward Staff Level 2: Alex demonstrated strong organizational influence by establishing company-wide distributed tracing standards.
- Feedback received: Praised for clear architectural RFCs; advised to delegate initial PR reviews to Senior leads to protect deep work time.

## Decisions & Commitments
- Agreed to block Tuesday and Thursday afternoons on Alex's calendar for uninterrupted architectural prototyping.
- Alex will lead the upcoming quarterly architecture forum on schema evolution.

## Action Items
- [ ] Manager: Discuss noise insulation strategies with product management for the platform pod
- [ ] Alex: Draft the schema evolution RFC draft by next Wednesday
- [ ] Manager: Review Alex's peer feedback submissions for upcoming review cycle

Because this file is pure Markdown on your local Mac disk, it integrates natively with Obsidian and text editors. You can version it in a private Git repository or search it in milliseconds using full-text search.

Defending employee privacy and trust

As an engineering leader, protecting your team’s confidential reflections is an ethical obligation. Using third-party cloud transcription tools exposes raw audio of sensitive discussions to external vendors, data brokers, and artificial intelligence model training sets.

Oyma operates under strict local-first security:

  • Zero audio egress: Audio stays in local RAM during the call and is processed offline by Whisper on Apple Silicon.
  • Audit transparency: You can verify with the built-in Egress Log that no employee dialogue is ever dispatched to external servers.
  • Permanent file ownership: Your management records remain open Markdown files on your disk forever, free from subscription lock-in or SaaS provider outages.

Lead your engineering team with genuine empathy, airtight confidentiality, and effortless documentation in plain Markdown.

How does Oyma protect direct report confidentiality during 1-on-1s?

Unlike cloud meeting tools that stream voice recordings to remote SaaS servers, Oyma runs transcription entirely on your Mac's Apple Silicon hardware. Audio never touches external networks, preserving confidential compensation, burnout, and performance discussions.

Does an attendee bot show up in my Zoom or Google Meet 1-on-1?

No. Oyma utilizes macOS ScreenCaptureKit to record system output and your microphone natively at the operating system tier. Direct reports experience a normal, unmonitored human conversation with zero bot presence.

Can I track individual engineer career progression over multiple quarters?

Yes. By creating a dedicated Markdown file for each direct report (e.g., `teammates/alex-chen.md`) and using [[WikiLinks]], every 1-on-1 meeting note automatically links back to their ongoing timeline and promotion dossier.

Can I use Oyma alongside my existing Obsidian vault?

Yes. Oyma reads and writes standard Markdown files directly on your local drive with zero proprietary database wrapping. Your notes appear instantly in Obsidian, VS Code, or any plain text editor.

Sovereign engineering managers notes in plain Markdown.

Free during the private beta. Apple silicon Macs, macOS 14 or later.

One email when your invite is ready. No newsletter.