manager-os

An AI-driven operating system for technology leaders. See docs/plan.md for the full design.

Quick Start

# Install Go via mise
mise install

# Run setup (creates memory files, installs Amp skills)
manager-os setup

# Chat (launches Amp and adds local ./skills to amp.skills.path)
manager-os chat

Commands

• manager-os setup — interactive onboarding (creates memory files, installs skills)
• manager-os chat — launches Amp for interactive chat, injecting local ./skills when present
• manager-os memory recall <query> — search the knowledge graph
• manager-os memory remember --about "Name" --content "note" — store a note
• manager-os memory relate --subject "Alice" --predicate reports_to --object "Bob" — create a relationship
• manager-os memory log "entry" — append to today's daily note
• manager-os memory doctor — run consistency checks on memory files
• manager-os memory people sync --source manual|hibob [--enrich-email-aliases] — validate manual people data or import from HiBob, with optional Google alias enrichment
• manager-os memory org-chart — generate org chart document from graph relationships
• manager-os memory read <path> — read a file from the memory directory
• manager-os memory write <path> --content "..." — write a file to the memory directory

All memory subcommands output markdown by default. Use --json for machine-readable output.

Architecture

cmd/manager-os/        CLI entrypoint (chat, setup, memory subcommands)
internal/
  git/                 Git versioning for memory directory
  graph/               Memory graph (markdown parser, wiki-links, search)
  paths/               XDG data directory resolution
  setup/               Interactive onboarding + skill installation
  logger/              Structured logging
skills/                Amp skills (embedded in binary, installed to ~/.config/agents/skills/)
  managing-people/     Memory graph via manager-os CLI
  managing-calendar/   Google Calendar via gog CLI
  granola/             Meeting notes via granola-cli
  slack/               Slack via slack-cli
  notion/              Notion via notion-cli
  google-groups/       Google Groups via gog CLI
docs/
  plan.md              Full design document
  memory.md            Memory system design
  memory-versioning.md Git versioning design

Skills

Skills are embedded in the binary and installed to ~/.config/agents/skills/ during manager-os setup. Each skill teaches Amp how to use a specific CLI tool:

When running manager-os chat from this repository, local ./skills is also appended to Amp's amp.skills.path for that session.

Skill	CLI	Purpose
managing-people	manager-os memory	Knowledge graph (recall, remember, relate)
managing-calendar	gog calendar	Google Calendar
granola	granola-cli	Meeting notes & transcripts
slack	slack-cli	Slack messages & search
notion	notion-cli	Notion pages & databases
google-groups	gog groups	Google Groups

Configuration

Variable	Default	Description
MEMORY_PATH	~/.local/share/manager-os/memories	Path to memory files
BOB_SERVICE_USER	(unset)	HiBob service user ID for optional memory people sync --source hibob
BOB_TOKEN	(unset)	HiBob API token for optional memory people sync --source hibob
GOG_ACCOUNT / GOOGLE_ACCOUNT	(unset)	Optional default Google account for gog people lookups during alias enrichment

Development

mise run check    # build + test + lint
mise run install  # install to active GOBIN (mise-managed when using mise Go)
mise run install:global # install to ~/.local/bin
mise run chat     # start interactive chat via go run