README file from
GithubTeam Manager
Run your team from Obsidian. Team Manager turns plain markdown notes into a management workspace: a people dashboard with cadence health, 1:1s with an agenda buffer that never loses a thought, recurring meetings that track their own rhythm, projects on a Kanban board, performance observations you jot down as they happen, a calendar that turns events into meeting notes, and one universal quick capture to file any of it in two keystrokes.
Everything is stored as ordinary markdown with YAML frontmatter — no database, no lock-in. Turn the plugin off and your notes are still notes.
Features
- People dashboard — cards or an editable list, grouped by relationship (yourself / team / peers / leadership / others) or by team, each group foldable. Cards carry a colored cadence-health ring, days since the last 1:1 and counters that link straight to where they live. In the list view you edit relationship, team, active status, email and the name itself without leaving the row. Five tabs: People, Meetings, Calendar, Projects, Action items.
- 1:1s with an agenda buffer — throughout the week, capture things to raise; they wait under a heading in the person's note. Starting a new 1:1 pulls them into the meeting and clears the buffer. Open action items (unchecked checkboxes) roll forward automatically.
- Recurring meetings — standups, weeklies, any ritual. A series holds the cadence and the default participants; each session starts from that list and pulls in whatever you buffered for it. Its own hub tracks attendance per person, open items across sessions, and flags a ritual that quietly stopped happening.
- Calendar — subscribe to a calendar and see it as an agenda, a day, three days, a week or a month. One click turns an event into the right meeting note, dated, with the guests it recognizes already filled in. Read-only: the plugin never writes to your calendar. See Calendar below.
- Live context panel — open a 1:1, person or project note and a side panel mirrors it: buffered agenda, open items, active projects with staleness, and the recent history — all expandable inline. A discreet toggle hides performance observations while screen-sharing.
- Projects & Kanban — a board with statuses as columns and owners as rows. Drag to change status; drag across rows to reassign. Configurable statuses.
- Performance — jot observations the moment you notice them; they accumulate and pre-fill the next review. Overdue-review nudges for your team.
- Quick capture — one command, one modal: pick the type (1:1 / observation / project log), the person or project, the destination, type the note. Fully keyboard-driven.
- Live hubs in your notes — a person note renders its own dashboard at the
top via a
team-hubcode block; project notes get ateam-projectblock.
Install
Community plugins (recommended, once approved)
Settings → Community plugins → Browse → search Team Manager → Install → Enable.
BRAT (beta, available now)
- Install the BRAT plugin from Community plugins.
- BRAT → Add beta plugin → paste
andyguy-dot/obsidian-team-manager. - Enable Team Manager in Community plugins.
Manual
Download main.js, manifest.json and styles.css from the
latest release
into <vault>/.obsidian/plugins/team-manager/, then enable it.
Calendar
Team Manager reads a calendar over its secret iCal address, so there is no Google Cloud project to create and no OAuth app to approve. In Google Calendar: Settings → pick the calendar → Secret address in iCal format. Paste it into Settings → Team Manager → Calendar. You can add several.
Two things worth knowing:
- That URL is a credential. Anyone holding it can read the whole calendar,
and it is stored in this plugin's
data.jsonin plain text like every other setting. Treat it the way you treat a password. - The feed lags. Google serves that address from a cache, so a brand-new invite can take a while to appear. The header shows when it last synced and there is a manual refresh, so the delay is visible rather than mysterious.
This is the only feature that talks to the network, and it only ever reads.
Guests are matched to your person notes by the email field; the ones it does
not recognize can be created straight from the event, with their address
already filled in.
Getting started
On first run the plugin creates a Team Manager/ folder with People/,
Meetings/, Performance/ and Projects/ subfolders (all configurable in
settings). Open the dashboard from the ribbon (the people icon) or the command
Open team dashboard, then hit + Person.
A note is recognized only when it has the right type and lives in the
matching folder, so the rest of your vault is left untouched.
Data model
Everything is frontmatter on normal notes.
Person — People/Jane Doe.md
---
type: person
role: Staff Engineer
team: Platform
status: active
relation: team # team | peer | manager | other
cadence: 14 # days, or weekly / biweekly / monthly
---
1:1 — Meetings/2026-07-16 Jane Doe.md
---
type: meeting
person: "[[Jane Doe]]"
date: 2026-07-16
---
Project — Projects/Auth migration.md
---
type: project
status: in progress
people:
- "[[Jane Doe]]"
priority: high
---
Performance — Performance/Jane Doe - 2026-H1.md
---
type: performance
person: "[[Jane Doe]]"
period: 2026-H1
rating: Exceeds # free text, not a fixed scale
---
Commands
| Command | What it does |
|---|---|
| Open team dashboard | The main view |
| Quick capture | Type-first capture into any destination |
| New person / New 1:1 / New project / New performance note | Create notes |
| Add to next 1:1 | Buffer an agenda item for someone |
| Add project log entry | Timestamped update on a project |
| New recurring meeting | Create a series (standup, weekly) |
| New session of a recurring meeting | Hold the next one, with its regulars and buffer |
| Insert hub block in this note | Add the live dashboard to a person/project/series note |
| Create folder structure | (Re)create the configured folders |
Bind Quick capture to a hotkey (Settings → Hotkeys) for two-keystroke capture from anywhere in Obsidian.
Mobile
Team Manager loads on mobile and quick capture, browsing, the calendar and the hubs all work. Drag-and-drop on the Kanban and right-click menus (delete, status change) are desktop-only, since touch has neither — organize on desktop, capture anywhere.
Development
npm install
npm run dev # watch build
npm run build # type-check + production build
main.js is a build artifact and is git-ignored; releases are produced by the
GitHub Actions workflow when a version tag is pushed.
License
MIT © André