Marvis

A multi-view project planner and habit tracker for Obsidian. Projects, milestones, tasks, logs, habits and events are real markdown notes; views (Kanban, Timeline, Calendar, Table) sit on top.

Highlights

🖥️ Four views, one source of truth

Kanban, Timeline (Gantt), Calendar, and Table all render the same data — every project, milestone, task, log, and event is a real markdown note with frontmatter. Drag-and-drop, filtering by project / milestone / status / priority / tag / date, and fuzzy text search work consistently across all four.

🦜 Live voice AI assistant

Talk to your planner — voice or text — via Google Gemini Live. Knows your projects and the note you have open, so "add a task here, high priority, due Friday" or "what's on my plate today?" just works. Every vault write is gated by a confirmation modal. Bring your own Gemini API key; nothing is proxied.

📆 Apple Calendar sync (macOS)

Pull any of your Apple Calendars into the vault as real Marvis events — markdown notes that participate in every view. One-way (external → vault), idempotent, recurrence-aware, with invitation status surfaced visually.

🦾 Coding agents as project managers

Symlink a Marvis project folder into your code repo and the bundled marvis-project skill teaches Claude Code, Cursor, etc. how to pick tasks, update status, and append work logs against your real planning notes. Because every task is its own file, you can run multiple assistant sessions in parallel on different tasks — nothing collides.

📱 Mobile-ready

Every view works on Obsidian iOS and Android. The toolbar collapses into a mobile nav bar, filters and create flows open as full-screen modals, and tap targets are sized for thumbs. macOS-only features (Apple Calendar sync) hide themselves on other platforms.

Features

• Four switchable views over the same data:
  • Kanban — group by status, priority, or milestone.
  • Timeline — Gantt-style with day/week/month zoom, grouped by project or milestone, with overlap-aware lane packing so rows stay compact.
  • Calendar — month/week/day modes; events render with response-status cues (needs-response, tentative, declined).
  • Table — per-kind sub-tabs for tasks, projects, milestones, events, and logs, all sortable.
• First-class entities — projects, milestones, tasks, logs, and events are notes with frontmatter, fully compatible with Dataview/Bases.
• Stable IDs — every item gets a T-/L-/M-/P-/E- code; backfill command for existing vaults.
• Filtering & search — project, milestone, status, priority, tag, date range, fuzzy text; tab-aware (the Project chip hides on the Projects table, etc.).
• Drag-and-drop — reorder/restage in Kanban (fractional indexing), reschedule and resize in Timeline, drag events in Calendar.
• Quick-create with smart parsing: Fix login !high due:tomorrow @Brison #bug.
• Quick log to capture timestamped notes against a project.
• Recurring tasks/events via RRULE.
• Customisable statuses & priorities with colours; configurable root folder and view defaults.
• Apple Calendar sync (macOS) — one-way pull of events into the vault, mapped to projects.
• Conversational AI assistant (Gemini Live, voice + text) — docks as a right-sidebar panel; aware of your projects and the file you have focused so deictic references ("this task", "the current note") resolve automatically; every vault change is gated by a confirmation modal; transcripts can be persisted to _chats/.
• Per-project coding-agent skill — each project gets a skills/marvis.md scaffolded from a configurable template, so external agents (Claude Code, Cursor, …) can pick up project conventions automatically.
• Archive — move done tasks into a project's archive/ folder.
• Mobile-friendly — works on Obsidian mobile (macOS-only features like Apple Calendar sync degrade gracefully).

Vault layout

Marvis/
  Project Life/
    _project.md
    milestones/v1.md
    tasks/Fix-login.md
    logs/2026-05-04-09-30-00.md
    events/2026-05-10-kickoff.md
    skills/marvis.md
    archive/

Development

npm install
npm run dev      # esbuild watch
npm run build    # tsc + esbuild production

To test in a real vault, symlink this folder into <vault>/.obsidian/plugins/marvis/.

See CONTRIBUTING.md for the full setup + contribution flow, and ARCHITECTURE.md for the code map and conventions.

Support

Marvis is free and MIT-licensed. If it saves you time, you can sponsor ongoing development via GitHub Sponsors or buy me a coffee — both pay for new features, faster issue triage, and the occasional coffee.

Security

Found a vulnerability? Please don't open a public issue — see SECURITY.md.

License

MIT © Mahdi Massahi