OrbitOS

English | 中文

An AI-powered personal productivity system where knowledge management and daily task planning are intelligently orchestrated by your AI assistant.

Installation

Option 1: Git Sparse Checkout (downloads only English version)

git clone --filter=blob:none --sparse https://github.com/MarsWang42/OrbitOS.git my-vault
cd my-vault
git sparse-checkout set EN
mv EN/* EN/.* . 2>/dev/null; rmdir EN

Option 2: Using degit (no git history, simpler)

npx degit MarsWang42/OrbitOS/EN my-vault

---

What is OrbitOS?

OrbitOS is an Obsidian-based productivity framework designed around a simple principle: everything orbits around you. Your projects, knowledge, and daily tasks stay in motion and connected — all managed through natural language conversations with AI.

Unlike traditional note-taking systems that require manual organization, OrbitOS leverages Claude Code or Gemini CLI as your intelligent knowledge manager and daily planner. The AI doesn't just store your information — it actively helps you:

• Capture ideas and transform them into structured, actionable projects
• Plan your day with context-aware recommendations based on your active work
• Research topics and automatically organize findings into your knowledge base
• Connect the dots between notes, projects, and concepts through smart wikilinks
• Archive and clean up completed work to keep your system lean and focused

Key Features

AI-Driven Workflows

Every major workflow is initiated through simple slash commands, with the AI handling the heavy lifting:

| Workflow | What the AI Does | | --------------------- | ----------------------------------------------------------------------------------------------------- | | Daily Planning | Reviews yesterday's progress, surfaces active projects, recommends focus areas, processes inbox items | | Project Creation | Converts rough ideas into structured projects with objectives, phases, and success metrics | | Research | Conducts deep dives, structures findings, creates atomic wiki entries, builds knowledge connections | | Knowledge Parsing | Takes unstructured text and organizes it into your vault with proper categorization and linking | | Archiving | Identifies completed items and moves them to archives while preserving historical context |

Intelligent Knowledge Graph

OrbitOS uses wikilinks extensively to build a connected knowledge graph:

• Projects link to related Research notes for context and reference
• Daily notes link to projects you worked on each day
• Wiki entries are atomic concepts that can be referenced from anywhere
• Research notes synthesize information and link to source concepts

The AI automatically creates these connections as you work, building a web of knowledge over time.

Structured Yet Flexible

The folder structure provides clear organization while remaining adaptable:

├── 00_Inbox/          # Quick captures — the AI processes these into proper locations
├── 10_Daily/          # Daily logs (YYYY-MM-DD.md) — AI-generated each morning
├── 20_Project/        # Active projects — AI helps create and track progress
├── 30_Research/       # Deep research notes — AI-structured from your explorations
├── 40_Wiki/           # Atomic concepts — AI extracts reusable definitions
├── 50_Resources/      # Curated content — newsletters, product launches, references
├── 90_Plans/          # Execution plans — AI drafts, you approve, then archived
└── 99_System/         # System configuration
    ├── Archives/      # Historical records (organized by year/month)
    ├── Prompts/       # AI personas for different domains
    └── Templates/     # Markdown templates for consistency

---

Getting Started

Prerequisites

1. Install Obsidian — Download (macOS, Windows, Linux)
2. Install an AI Assistant (choose one):
   • Claude Code — npm install -g @anthropic-ai/claude-code (Documentation)
   • Gemini CLI — npm install -g @google/gemini-cli (Documentation)
3. Open the vault folder in Obsidian and run your AI assistant from the same directory
4. Recommended: Install the Terminal plugin to run Claude Code directly within Obsidian — this provides a seamless experience without switching between apps

Your First Day

1. Capture your first idea: Drop a quick note in 00_Inbox/.

   • Just write down a thought, project idea, or something you want to explore
   • Don't worry about formatting — the AI will help structure it later

2. Start your day: Run /start-my-day in your AI assistant

   • The AI will scan your inbox and surface items to process
   • Review any active projects (empty on day one, and that's okay!)
   • Generate a daily note with recommendations

3. Kick off a project: Run /kickoff to transform an inbox item into a project

   • The AI will draft a plan and ask clarifying questions
   • Creates a structured project with objectives, phases, and success metrics

4. Research something: Run /research <topic>

   • The AI conducts a thorough investigation
   • Creates structured notes in 30_Research/
   • Extracts atomic concepts to 40_Wiki/
   • Links everything together automatically

5. Ask a quick question: Run /ask <question>

   • Get a direct answer without creating heavy documentation
   • Optionally save useful findings to your wiki

---

Command Reference

Core Workflows

| Command | Purpose | When to Use | |---------|---------|-------------| | /start-my-day | AI-guided daily planning and review | Every morning to set your focus | | /kickoff | Transform ideas into structured projects | Starting any new initiative | | /research | Deep dive with automatic knowledge structuring | Learning something comprehensively | | /ask | Quick answers without heavy note-taking | Simple questions, fact lookups | | /brainstorm | Interactive idea exploration | Developing and refining concepts | | /parse-knowledge | Structure unstructured text into vault | Processing notes, articles, meeting transcripts | | /archive | Clean up completed items | Regular maintenance, project completion |

Obsidian-Specific Features

| Skill | Purpose | |-------|---------| | obsidian-markdown | Wikilinks, callouts, embeds, and Obsidian-flavored syntax | | obsidian-bases | Create database-like views with filters and formulas (.base files) | | json-canvas | Visual mind maps and flowcharts (.canvas files) |

Content Curation (Optional)

| Command | Purpose | | ----------------- | ------------------------------------------------------------------ | | /ai-newsletters | Curate and summarize AI newsletters (TLDR AI, The Rundown AI) | | /ai-products | Discover AI product launches from Product Hunt, HN, GitHub, Reddit |

---

Project Concepts

The C.A.P. Project Layout

Every project follows a consistent structure:

• Context: What are we trying to achieve? What does success look like?
• Actions: Phased checklists of tasks to complete
• Progress: Timestamped updates linking to daily notes

Wikilinks and Connections

OrbitOS relies heavily on Obsidian's wikilink syntax:

[[NoteName]]                  # Basic link
[[NoteName|Display Text]]     # Custom display text
![[NoteName]]                 # Embed entire note
![[NoteName#Section]]         # Embed specific section

The AI creates these links automatically, but you should also link liberally — connections create value.

Daily Notes as the Anchor

Daily notes (10_Daily/YYYY-MM-DD.md) serve as your central anchor:

• Every project update references the daily note where work happened
• Inbox items are processed and linked from daily notes
• The /start-my-day workflow generates these automatically

---

Philosophy

OrbitOS is built on these principles:

1. AI as Partner: The AI isn't just a tool — it's an active collaborator that understands your system and helps maintain it
2. Capture Everything, Process Later: The inbox exists so you never lose an idea; the AI helps you process when ready
3. Connections Over Categories: Rigid folder hierarchies fail; wikilinks create a flexible, queryable knowledge graph
4. Daily Rhythm: The daily note anchors everything, creating a timeline of your work and thoughts
5. Progressive Formalization: Ideas start rough and become structured over time through AI-assisted refinement

---

License

MIT License — Use freely, modify as needed, share with others.