claude-home 1.5.26 → 1.5.31

package/README.md

@@ -2,28 +2,53 @@
 
 A local web dashboard for [Claude Code](https://claude.ai/code) power users.
 
-Browse your session history, manage skills, agents, hooks, commands, plans, and discover community skills — all from a clean UI. No tokens consumed. Runs entirely on your machine.
+Browse your session history, manage skills, agents, hooks, commands, plans, and notes — all from a clean UI. No tokens consumed. Runs entirely on your machine.
 
 ---
 
 ## Why claude-home?
 
-Claude Code is powerful but headless. Everything lives in files scattered across `~/.claude/` and your project directories. claude-home gives you a visual interface to explore and manage all of it:
+Claude Code is powerful but headless. Everything lives in files scattered across `~/.claude/` and your project directories. claude-home gives you a visual interface to explore and manage all of it — and a **second brain** layer that persists what you build with Claude day to day.
 
-- **Session history** — browse every conversation you've had with Claude, search by content, resume from where you left off
-- **Skills** — view, create, edit and delete your user and project skills. Discover and install new ones from the community marketplace or any GitHub URL
-- **Agents** — manage your custom agent definitions with full CRUD
-- **Instructions** — read and edit your `CLAUDE.md` files (global and per-project), the instructions that shape Claude's behavior in every session
-- **Permissions** — inspect the allow/deny lists that control what Claude can do in each project
-- **Hooks** — view and manage all your configured hooks across global and project settings
-- **Commands** — browse your slash command library
-- **Plans** — read and search your GSD/planning files
-- **Memory** — inspect your auto-memory entries across projects
-- **Configuration** — view Claude settings per project
+---
+
+## Features
+
+### Sessions
+Browse every conversation you've had with Claude. Search by content, filter by project or branch, resume from where you left off, export as Markdown, or publish as a public GitHub Gist. Direct shareable links (`#/session/...`) let you bookmark or share specific conversations.
+
+### Today
+A daily task list that lives alongside your Claude work. Add tasks, provide context (hours available, meetings, energy), and hit **Copy for Claude** to get a formatted prompt ready to paste for prioritization. Uncompleted tasks carry over automatically to the next day.
+
+Claude can add tasks directly from any session — just say "add this to today" or "remind me tomorrow to…"
+
+### Notes
+Your personal notepad — separate from Claude's memory. Notes are for you, not for Claude's context. Capture decisions, TILs, bug solutions, runbooks, snippets, or anything worth keeping.
+
+Claude can save notes directly from any session — just say "save this as a note". One-click setup from **Config → Integrations** adds the instruction to your `CLAUDE.md` automatically and grants the necessary write permissions.
+
+Direct links (`#/note/filename`) let you open a specific note instantly.
+
+### Projects
+Visual overview of all your Claude projects with session count, token usage, cost, and memory files. Drill into any project to browse its sessions, memory entries, and `CLAUDE.md` files.
+
+### Plans
+Read and search your GSD/planning files from `~/.claude/plans/`. Export or publish as a Gist with one click.
+
+### Memory
+Inspect your auto-memory entries across all projects.
+
+### Skills & Agents
+View, create, edit and delete your user and project skills and custom agent definitions. Discover and install new skills from the community marketplace or any GitHub URL.
 
-### No tokens. No cloud. No tracking.
+### Instructions & Config
+Read and edit your `CLAUDE.md` files (global and per-project). Inspect permissions, hooks, and Claude settings per project.
 
-claude-home is a local Express server that reads your `~/.claude/` directory directly. It never calls the Claude API, never sends data anywhere, and works completely offline (except for the marketplace feature, which optionally fetches from GitHub).
+---
+
+## No tokens. No cloud. No tracking.
+
+claude-home is a local Express server that reads your `~/.claude/` directory directly. It never calls the Claude API, never sends data anywhere, and works completely offline (except for the marketplace and Gist sharing features).
 
 ---
 
@@ -91,6 +116,23 @@ Commands:
 
 ---
 
+## Claude integration (Notes & Today)
+
+claude-home can receive content directly from Claude during active sessions. Go to **Config → Integrations** and click **Set up** — this adds instructions to your `~/.claude/CLAUDE.md` and grants the necessary write permissions automatically.
+
+Once set up, from any Claude session you can say:
+- *"Save this as a note"* → creates a note in the Notes view
+- *"Add this to today's tasks"* → adds a task to the Today view
+- *"Remind me tomorrow to…"* → adds a task to tomorrow's list
+
+---
+
+## Sharing
+
+Publish sessions or plans as public GitHub Gists. Go to **Config → Sharing**, add a GitHub personal access token with the `gist` scope, and use the **Gist** button in any session or plan.
+
+---
+
 ## Skills Marketplace
 
 claude-home includes a marketplace to discover and install skills from GitHub repositories.

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "claude-home",
-  "version": "1.5.26",
+  "version": "1.5.31",
   "description": "Web dashboard for Claude Code — browse sessions, manage skills, hooks, commands, and agents",
   "main": "server.js",
   "bin": {

package/public/index.html

@@ -1519,6 +1519,18 @@
     </div>
 
     <div class="nav-section">
+      <div class="nav-item" :class="{ active: view === 'today' }" @click="view='today';selectedSession=null;loadToday()">
+        <span class="nav-icon">
+          <svg width="16" height="16" viewBox="0 0 16 16" fill="none" stroke="currentColor" stroke-width="1.5">
+            <rect x="2" y="2" width="12" height="12" rx="1"/>
+            <line x1="5" y1="2" x2="5" y2="5"/><line x1="11" y1="2" x2="11" y2="5"/>
+            <line x1="2" y1="7" x2="14" y2="7"/>
+            <text x="5" y="13" font-size="5" fill="currentColor" stroke="none" font-weight="bold" x-text="new Date().getDate()"></text>
+          </svg>
+        </span>
+        Today
+        <span class="nav-count" x-show="todayData && todayData.tasks.filter(t=>!t.done).length > 0" x-text="todayData ? todayData.tasks.filter(t=>!t.done).length : ''"></span>
+      </div>
       <div class="nav-item" :class="{ active: view === 'dashboard' }" @click="view='dashboard';selectedSession=null;loadStats();loadInsights()">
         <span class="nav-icon">
           <svg width="16" height="16" viewBox="0 0 16 16" fill="none" stroke-width="1.5">
@@ -2534,6 +2546,84 @@
       </div>
     </template>
 
+    <!-- Today view -->
+    <template x-if="view === 'today' && !selectedSession">
+      <div style="display:flex;flex-direction:column;height:100%;overflow:hidden;">
+        <div class="topbar">
+          <span class="topbar-title">Today</span>
+          <span style="font-size:11px;color:var(--ink-3)" x-text="new Date().toLocaleDateString('en-US',{weekday:'long',month:'long',day:'numeric'})"></span>
+          <div style="margin-left:auto;display:flex;gap:8px;align-items:center">
+            <span x-show="todayCopied" style="font-size:12px;color:var(--green)" x-transition>Copied!</span>
+            <button class="btn btn-sm" style="background:var(--canvas-2);color:var(--ink);border:1px solid var(--rule)" @click="copyTodayForClaude()" title="Copy tasks + context formatted for Claude">Copy for Claude</button>
+          </div>
+        </div>
+        <div style="flex:1;overflow-y:auto;padding:24px;max-width:680px;width:100%">
+          <template x-if="todayLoading"><div class="loading"><div class="spinner"></div> Loading…</div></template>
+          <template x-if="!todayLoading && todayData">
+            <div style="display:flex;flex-direction:column;gap:20px">
+
+              <!-- Context -->
+              <div>
+                <div style="font-size:11px;font-weight:600;color:var(--ink-3);text-transform:uppercase;letter-spacing:.05em;margin-bottom:6px">Context for today</div>
+                <textarea x-model="todayData.context" @input="saveToday()" placeholder="Hours available, meetings, energy level, deadlines…" rows="2" style="width:100%;background:var(--canvas-2);border:1px solid var(--rule);border-radius:6px;padding:8px 10px;font-size:12px;color:var(--ink);font-family:inherit;resize:vertical;box-sizing:border-box"></textarea>
+              </div>
+
+              <!-- Task list -->
+              <div>
+                <div style="font-size:11px;font-weight:600;color:var(--ink-3);text-transform:uppercase;letter-spacing:.05em;margin-bottom:10px">
+                  Tasks — <span x-text="todayData.tasks.filter(t=>!t.done).length"></span> pending
+                </div>
+
+                <!-- Carried over -->
+                <template x-if="todayData.tasks.some(t => t.carriedOver && !t.done)">
+                  <div style="margin-bottom:8px">
+                    <div style="font-size:10px;color:var(--ink-3);margin-bottom:4px">↩ Carried over</div>
+                    <template x-for="task in todayData.tasks.filter(t => t.carriedOver && !t.done)" :key="task.id">
+                      <div style="display:flex;align-items:center;gap:8px;padding:6px 0;border-bottom:1px solid var(--rule)">
+                        <input type="checkbox" :checked="task.done" @change="toggleTodayTask(task.id)" style="flex-shrink:0;cursor:pointer" />
+                        <span x-text="task.text" style="flex:1;font-size:13px;color:var(--ink-2)"></span>
+                        <button @click="deleteTodayTask(task.id)" style="background:none;border:none;color:var(--ink-3);cursor:pointer;font-size:14px;padding:0 2px;line-height:1" title="Remove">×</button>
+                      </div>
+                    </template>
+                  </div>
+                </template>
+
+                <!-- Today's tasks -->
+                <template x-for="task in todayData.tasks.filter(t => !t.carriedOver && !t.done)" :key="task.id">
+                  <div style="display:flex;align-items:center;gap:8px;padding:6px 0;border-bottom:1px solid var(--rule)">
+                    <input type="checkbox" :checked="task.done" @change="toggleTodayTask(task.id)" style="flex-shrink:0;cursor:pointer" />
+                    <span x-text="task.text" style="flex:1;font-size:13px;color:var(--ink)"></span>
+                    <button @click="deleteTodayTask(task.id)" style="background:none;border:none;color:var(--ink-3);cursor:pointer;font-size:14px;padding:0 2px;line-height:1" title="Remove">×</button>
+                  </div>
+                </template>
+
+                <!-- Done tasks -->
+                <template x-if="todayData.tasks.some(t => t.done)">
+                  <div style="margin-top:12px">
+                    <div style="font-size:10px;color:var(--ink-3);margin-bottom:4px">✓ Done</div>
+                    <template x-for="task in todayData.tasks.filter(t => t.done)" :key="task.id">
+                      <div style="display:flex;align-items:center;gap:8px;padding:6px 0;border-bottom:1px solid var(--rule);opacity:0.5">
+                        <input type="checkbox" :checked="task.done" @change="toggleTodayTask(task.id)" style="flex-shrink:0;cursor:pointer" />
+                        <span x-text="task.text" style="flex:1;font-size:13px;text-decoration:line-through;color:var(--ink-3)"></span>
+                        <button @click="deleteTodayTask(task.id)" style="background:none;border:none;color:var(--ink-3);cursor:pointer;font-size:14px;padding:0 2px;line-height:1" title="Remove">×</button>
+                      </div>
+                    </template>
+                  </div>
+                </template>
+
+                <!-- Add task -->
+                <div style="display:flex;gap:8px;margin-top:12px">
+                  <input class="search-input" type="text" x-model="todayNewTask" placeholder="Add a task…" style="flex:1;font-size:13px" @keydown.enter="addTodayTask()" />
+                  <button class="btn btn-primary btn-sm" @click="addTodayTask()" :disabled="!todayNewTask.trim()">Add</button>
+                </div>
+              </div>
+
+            </div>
+          </template>
+        </div>
+      </div>
+    </template>
+
     <!-- Plans view -->
     <template x-if="view === 'plans' && !selectedSession">
       <div style="display:flex;flex-direction:column;height:100%;overflow:hidden;">
@@ -4338,6 +4428,11 @@
         planExportMsg: '',
         planExportOpen: false,
         planShareMsg: '',
+        todayData: null,
+        todayLoading: false,
+        todayNewTask: '',
+        todaySaveTimer: null,
+        todayCopied: false,
         personalNotes: [],
         personalNotesLoading: false,
         selectedNote: null,
@@ -4518,6 +4613,7 @@
           this.loadStatus();
           this.loadInsights();
           // Load counts for nav badges without blocking
+          this.loadToday();
           this.loadPlans();
           this.loadAgents();
           this.loadTools();
@@ -4529,7 +4625,8 @@
           const mNote = hash.match(/^#\/note\/(.+)$/);
           if (mSession) { this.view = 'sessions'; await this.openSessionById(mSession[2], mSession[1]); }
           if (mNote) {
-            await this.loadPersonalNotes();
+            const notes = await fetch('/api/notes').then(r => r.json()).catch(() => []);
+            this.personalNotes = notes;
             const note = this.personalNotes.find(n => n.filename === mNote[1]);
             if (note) { this.view = 'notes'; this.selectedNote = note; }
           }
@@ -4539,6 +4636,7 @@
         },
 
         initView(v) {
+          if (v === 'today')                { this.loadToday(); }
           if (v === 'dashboard')            { this.loadStats(); this.loadInsights(); }
           if (v === 'projects')             { this.loadProjects(); }
           if (v === 'memory')               { this.loadMemory(); }
@@ -5492,6 +5590,68 @@
           this.selectedSession = null;
         },
 
+        async loadToday() {
+          this.todayLoading = true;
+          this.todayData = await fetch('/api/today').then(r => r.json()).catch(() => null);
+          this.todayLoading = false;
+        },
+
+        saveToday() {
+          clearTimeout(this.todaySaveTimer);
+          this.todaySaveTimer = setTimeout(async () => {
+            if (!this.todayData) return;
+            await fetch('/api/today', {
+              method: 'PUT',
+              headers: { 'Content-Type': 'application/json' },
+              body: JSON.stringify({ context: this.todayData.context, tasks: this.todayData.tasks }),
+            });
+          }, 400);
+        },
+
+        addTodayTask() {
+          const text = this.todayNewTask.trim();
+          if (!text) return;
+          if (!this.todayData) return;
+          this.todayData.tasks.push({
+            id: Math.random().toString(36).slice(2),
+            text,
+            done: false,
+            carriedOver: false,
+            createdAt: new Date().toISOString(),
+          });
+          this.todayNewTask = '';
+          this.saveToday();
+        },
+
+        toggleTodayTask(id) {
+          const task = this.todayData?.tasks.find(t => t.id === id);
+          if (task) { task.done = !task.done; this.saveToday(); }
+        },
+
+        deleteTodayTask(id) {
+          if (!this.todayData) return;
+          this.todayData.tasks = this.todayData.tasks.filter(t => t.id !== id);
+          this.saveToday();
+        },
+
+        copyTodayForClaude() {
+          if (!this.todayData) return;
+          const date = this.todayData.date;
+          const ctx = this.todayData.context ? `\nContext: ${this.todayData.context}` : '';
+          const carried = this.todayData.tasks.filter(t => t.carriedOver && !t.done);
+          const fresh = this.todayData.tasks.filter(t => !t.carriedOver && !t.done);
+          const done = this.todayData.tasks.filter(t => t.done);
+          let text = `## My day — ${date}${ctx}\n`;
+          if (carried.length) text += `\n### Carried over from yesterday:\n${carried.map(t => `- [ ] ${t.text}`).join('\n')}\n`;
+          if (fresh.length) text += `\n### Today's tasks:\n${fresh.map(t => `- [ ] ${t.text}`).join('\n')}\n`;
+          if (done.length) text += `\n### Already done:\n${done.map(t => `- [x] ${t.text}`).join('\n')}\n`;
+          text += `\nPlease prioritize my pending tasks given the context and suggest a realistic order for today.`;
+          navigator.clipboard.writeText(text).then(() => {
+            this.todayCopied = true;
+            setTimeout(() => this.todayCopied = false, 2000);
+          });
+        },
+
         async saveSettings() {
           this.settingsSaving = true; this.settingsMsg = '';
           try {

package/server.js

@@ -1906,10 +1906,35 @@ When the user asks you to "save a note", "add to notes", "guarda esto como nota"
 
      <the content the user wants to save>
      \`\`\`
-2. Use the Bash tool to write the file.
+2. Use the Write tool to create the file (not Bash).
 3. Confirm with: "Saved to Notes: http://localhost:3141/#/note/<filename>"
 
-The notes directory may not exist yet — create it if needed with \`mkdir -p\`.
+The notes directory may not exist yet — the app creates it automatically on first load.
+
+## Daily TODOs (Today view)
+
+When the user asks to add a task "for today", "for tomorrow", "to review later", or similar:
+1. Determine the target date (today = current date, tomorrow = current date + 1 day)
+2. Read the existing file if it exists: \`~/.claude/claude-home/todos/YYYY-MM-DD.json\`
+3. Use the Write tool to save the updated file with this format:
+   \`\`\`json
+   {
+     "date": "YYYY-MM-DD",
+     "context": "",
+     "tasks": [
+       {
+         "id": "<random 8 char alphanumeric>",
+         "text": "<task description>",
+         "done": false,
+         "carriedOver": false,
+         "createdAt": "<current ISO date>"
+       }
+     ]
+   }
+   \`\`\`
+4. Confirm with: "Added to Today: http://localhost:3141 (Today section)"
+
+The todos directory may not exist yet — the app creates it automatically on first load.
 `;
 
 app.get('/api/notes/claude-md-status', (req, res) => {
@@ -1922,10 +1947,30 @@ app.get('/api/notes/claude-md-status', (req, res) => {
 
 app.post('/api/notes/setup-claude', (req, res) => {
   const claudeMdPath = path.join(os.homedir(), '.claude', 'CLAUDE.md');
+  const settingsPath = path.join(os.homedir(), '.claude', 'settings.json');
   try {
     const current = fs.existsSync(claudeMdPath) ? fs.readFileSync(claudeMdPath, 'utf8') : '';
     if (current.includes('Personal Notes')) return res.json({ ok: true, alreadyInstalled: true });
+    // Append CLAUDE.md snippet
     fs.writeFileSync(claudeMdPath, current + '\n' + NOTES_CLAUDE_MD_SNIPPET, 'utf8');
+    // Add Write permission for notes dir to settings.json
+    try {
+      const settings = fs.existsSync(settingsPath) ? JSON.parse(fs.readFileSync(settingsPath, 'utf8')) : {};
+      if (!settings.permissions) settings.permissions = {};
+      if (!settings.permissions.allow) settings.permissions.allow = [];
+      const rules = [
+        `Write(${path.join(os.homedir(), '.claude', 'claude-home', 'notes', '*')})`,
+        `Write(${path.join(os.homedir(), '.claude', 'claude-home', 'todos', '*')})`,
+      ];
+      let changed = false;
+      for (const rule of rules) {
+        if (!settings.permissions.allow.includes(rule)) {
+          settings.permissions.allow.push(rule);
+          changed = true;
+        }
+      }
+      if (changed) fs.writeFileSync(settingsPath, JSON.stringify(settings, null, 2) + '\n', 'utf8');
+    } catch {}
     res.json({ ok: true });
   } catch (e) { res.status(500).json({ error: e.message }); }
 });
@@ -1982,6 +2027,56 @@ app.delete('/api/notes/:filename', (req, res) => {
   } catch (e) { res.status(500).json({ error: e.message }); }
 });
 
+// ─── Today / Daily TODOs ──────────────────────────────────────────────────────
+const TODOS_DIR = path.join(DATA_DIR, 'todos');
+function ensureTodosDir() { if (!fs.existsSync(TODOS_DIR)) fs.mkdirSync(TODOS_DIR, { recursive: true }); }
+
+function todayStr() { return new Date().toISOString().slice(0, 10); }
+
+function readTodosFile(dateStr) {
+  const filePath = path.join(TODOS_DIR, `${dateStr}.json`);
+  try { return JSON.parse(fs.readFileSync(filePath, 'utf8')); } catch { return null; }
+}
+
+function writeTodosFile(dateStr, data) {
+  ensureTodosDir();
+  fs.writeFileSync(path.join(TODOS_DIR, `${dateStr}.json`), JSON.stringify(data, null, 2), 'utf8');
+}
+
+app.get('/api/today', (req, res) => {
+  ensureTodosDir();
+  const today = todayStr();
+  let data = readTodosFile(today);
+  if (!data) {
+    // Carry over undone tasks from most recent previous day
+    const files = fs.readdirSync(TODOS_DIR)
+      .filter(f => f.endsWith('.json') && f.slice(0, 10) < today)
+      .sort().reverse();
+    const carriedTasks = [];
+    if (files.length > 0) {
+      const prev = readTodosFile(files[0].slice(0, 10));
+      if (prev?.tasks) {
+        prev.tasks.filter(t => !t.done).forEach(t => {
+          carriedTasks.push({ ...t, carriedOver: true, done: false });
+        });
+      }
+    }
+    data = { date: today, context: '', tasks: carriedTasks };
+    writeTodosFile(today, data);
+  }
+  res.json(data);
+});
+
+app.put('/api/today', (req, res) => {
+  const today = todayStr();
+  const { context, tasks } = req.body;
+  const current = readTodosFile(today) || { date: today, context: '', tasks: [] };
+  if (context !== undefined) current.context = context;
+  if (tasks !== undefined) current.tasks = tasks;
+  writeTodosFile(today, current);
+  res.json(current);
+});
+
 // ─── Start ────────────────────────────────────────────────────────────────────
 
 function startServer(port) {