create-sessions-dir 0.1.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2025 Vieko Franetovic
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,84 @@
+# create-sessions-dir
+
+Scaffold a Sessions Directory for working with AI coding agents.
+
+## What is this?
+
+`create-sessions-dir` sets up the **Sessions Directory Pattern** in your project - a workflow for maintaining context across sessions with stateless AI agents like Claude Code.
+
+Instead of relying on the agent to "remember" previous conversations, you maintain a living document that gets read at session start and updated at session end. Simple, effective, and surprisingly powerful.
+
+**Learn more**: [Pairing with a Partner Who Forgets Everything](https://vieko.dev/sessions)
+
+## Quick Start
+
+Run this in any project directory:
+
+```bash
+npx create-sessions-dir
+```
+
+This creates:
+- `.sessions/` directory with context files
+- `.claude/commands/` with slash commands for Claude Code
+- Templates and workflow guide
+
+Then start your first session:
+```bash
+/start-session
+```
+
+## What Gets Created
+
+```
+.sessions/
+  index.md          # Your living context document
+  archive/          # For completed work
+  README.md         # Workflow guide and examples
+
+.claude/
+  commands/
+    start-session.md    # /start-session command
+    end-session.md      # /end-session command
+    archive-session.md  # /archive-session command
+```
+
+## Usage
+
+### Start a Session
+```
+/start-session
+```
+Claude reads your context and asks what you want to work on.
+
+### End a Session
+```
+/end-session
+```
+Claude updates your context with what happened and commits the changes.
+
+### Archive Completed Work
+```
+/archive-session
+```
+Claude moves finished work to the archive to keep your context file clean.
+
+## Requirements
+
+- Any project (works with any language/framework)
+- Claude Code CLI (optional but recommended for slash commands)
+
+## Why This Works
+
+AI coding agents are stateless - they don't remember previous sessions. The Sessions Directory Pattern solves this by:
+
+1. **Externalizing memory** - Context lives in files, not the agent's "memory"
+2. **Progressive documentation** - You document as you build, not after
+3. **Continuity across sessions** - Each session starts with full context
+4. **Proof of decisions** - Everything is written down and committed
+
+Read the full story: [vieko.dev/sessions](https://vieko.dev/sessions)
+
+## License
+
+MIT © [Vieko Franetovic](https://vieko.dev)

package/dist/index.d.ts

@@ -0,0 +1,3 @@
+#!/usr/bin/env node
+export {};
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":""}

package/dist/index.js

@@ -0,0 +1,129 @@
+#!/usr/bin/env node
+import { existsSync, mkdirSync, writeFileSync, readFileSync } from 'fs';
+import { join, dirname } from 'path';
+import { fileURLToPath } from 'url';
+import { execSync } from 'child_process';
+const __filename = fileURLToPath(import.meta.url);
+const __dirname = dirname(__filename);
+// Colors for terminal output
+const colors = {
+    reset: '\x1b[0m',
+    bright: '\x1b[1m',
+    green: '\x1b[32m',
+    yellow: '\x1b[33m',
+    blue: '\x1b[34m',
+    cyan: '\x1b[36m',
+};
+function log(message, color = colors.reset) {
+    console.log(`${color}${message}${colors.reset}`);
+}
+function checkExistingSessions() {
+    return existsSync('.sessions');
+}
+function checkClaudeCLI() {
+    try {
+        execSync('which claude', { stdio: 'ignore' });
+        return true;
+    }
+    catch {
+        return false;
+    }
+}
+function getProjectName() {
+    // Try to get from package.json
+    if (existsSync('package.json')) {
+        try {
+            const pkg = JSON.parse(readFileSync('package.json', 'utf-8'));
+            if (pkg.name)
+                return pkg.name;
+        }
+        catch {
+            // Fall through
+        }
+    }
+    // Try to get from git
+    try {
+        const gitRemote = execSync('git remote get-url origin', { encoding: 'utf-8' }).trim();
+        const match = gitRemote.match(/\/([^\/]+?)(?:\.git)?$/);
+        if (match)
+            return match[1];
+    }
+    catch {
+        // Fall through
+    }
+    // Use directory name
+    return process.cwd().split('/').pop() || 'My Project';
+}
+function getCurrentDate() {
+    const date = new Date();
+    const options = {
+        year: 'numeric',
+        month: 'long',
+        day: 'numeric'
+    };
+    return date.toLocaleDateString('en-US', options);
+}
+function getTemplateContent(filename) {
+    const templatesDir = join(__dirname, '..', 'templates');
+    const filePath = join(templatesDir, filename);
+    return readFileSync(filePath, 'utf-8');
+}
+function createSessionsDirectory() {
+    const projectName = getProjectName();
+    const currentDate = getCurrentDate();
+    // Create directories
+    mkdirSync('.sessions', { recursive: true });
+    mkdirSync('.sessions/archive', { recursive: true });
+    mkdirSync('.claude', { recursive: true });
+    mkdirSync('.claude/commands', { recursive: true });
+    log('\n✓ Created .sessions/ directory', colors.green);
+    log('✓ Created .sessions/archive/ directory', colors.green);
+    log('✓ Created .claude/commands/ directory', colors.green);
+    // Create index.md
+    const indexContent = getTemplateContent('sessions/index.md')
+        .replace('{{PROJECT_NAME}}', projectName)
+        .replace(/\{\{CURRENT_DATE(_\d+)?\}\}/g, currentDate);
+    writeFileSync('.sessions/index.md', indexContent);
+    log('✓ Created .sessions/index.md', colors.green);
+    // Create README.md
+    const readmeContent = getTemplateContent('sessions/README.md');
+    writeFileSync('.sessions/README.md', readmeContent);
+    log('✓ Created .sessions/README.md', colors.green);
+    // Create slash commands
+    const startSessionContent = getTemplateContent('claude/commands/start-session.md');
+    writeFileSync('.claude/commands/start-session.md', startSessionContent);
+    log('✓ Created .claude/commands/start-session.md', colors.green);
+    const endSessionContent = getTemplateContent('claude/commands/end-session.md');
+    writeFileSync('.claude/commands/end-session.md', endSessionContent);
+    log('✓ Created .claude/commands/end-session.md', colors.green);
+    const archiveSessionContent = getTemplateContent('claude/commands/archive-session.md');
+    writeFileSync('.claude/commands/archive-session.md', archiveSessionContent);
+    log('✓ Created .claude/commands/archive-session.md', colors.green);
+}
+function main() {
+    log('\n✨ create-sessions-dir', colors.cyan + colors.bright);
+    log('   Setting up Sessions Directory Pattern\n', colors.cyan);
+    // Check for existing .sessions directory
+    if (checkExistingSessions()) {
+        log('⚠️  .sessions/ directory already exists!', colors.yellow);
+        log('   Aborting to avoid overwriting existing files.\n', colors.yellow);
+        process.exit(1);
+    }
+    // Create the structure
+    createSessionsDirectory();
+    // Check for Claude CLI
+    const hasClaudeCLI = checkClaudeCLI();
+    log('\n' + '─'.repeat(50), colors.blue);
+    log('\n🎉 Sessions Directory created successfully!\n', colors.green + colors.bright);
+    if (!hasClaudeCLI) {
+        log('⚠️  Claude CLI not detected', colors.yellow);
+        log('   Install it to use slash commands:', colors.yellow);
+        log('   npm install -g @anthropic-ai/claude-code\n', colors.cyan);
+    }
+    log('Next steps:', colors.bright);
+    log('  1. Read the guide: .sessions/README.md');
+    log('  2. Start your first session with: /start-session');
+    log('  3. Learn more: https://vieko.dev/sessions\n');
+}
+main();
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"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"}

package/package.json

@@ -0,0 +1,45 @@
+{
+  "name": "create-sessions-dir",
+  "version": "0.1.0",
+  "description": "Scaffold a Sessions Directory for working with AI coding agents",
+  "type": "module",
+  "bin": {
+    "create-sessions-dir": "./dist/index.js"
+  },
+  "files": [
+    "dist",
+    "templates"
+  ],
+  "scripts": {
+    "build": "tsc",
+    "dev": "tsc --watch",
+    "prepublishOnly": "npm run build"
+  },
+  "keywords": [
+    "ai",
+    "claude",
+    "sessions",
+    "documentation",
+    "workflow",
+    "agent",
+    "scaffold"
+  ],
+  "author": "Vieko Franetovic <hello@vieko.dev>",
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/vieko/create-sessions-dir.git"
+  },
+  "bugs": {
+    "url": "https://github.com/vieko/create-sessions-dir/issues"
+  },
+  "homepage": "https://github.com/vieko/create-sessions-dir#readme",
+  "dependencies": {
+    "prompts": "^2.4.2"
+  },
+  "devDependencies": {
+    "@types/node": "^22.10.2",
+    "@types/prompts": "^2.4.9",
+    "typescript": "^5.7.2"
+  }
+}

package/templates/claude/commands/archive-session.md

@@ -0,0 +1,4 @@
+Review completed work in .sessions/ and archive it.
+
+Move finished session notes to .sessions/archive/ organized by date or topic.
+Clean up .sessions/index.md by removing completed items.

package/templates/claude/commands/end-session.md

@@ -0,0 +1,9 @@
+Update .sessions/index.md with what we accomplished this session.
+
+Include:
+- Today's date
+- What we built/fixed/decided
+- Any blockers or open questions
+- Next session priorities
+
+Then commit the changes with a descriptive message.

package/templates/claude/commands/start-session.md

@@ -0,0 +1,8 @@
+Read .sessions/index.md and report when ready.
+
+Summarize:
+- Current state
+- Recent work
+- Next priorities
+
+Then ask what I want to work on this session.

package/templates/sessions/README.md

@@ -0,0 +1,181 @@
+# Sessions Directory Pattern
+
+This directory implements the **Sessions Directory Pattern** for working with AI coding agents like Claude Code.
+
+## What is this?
+
+The Sessions Directory Pattern creates continuity across sessions with stateless AI agents. Instead of the agent trying to remember context, you maintain a living document that gets read at the start of each session and updated at the end.
+
+**Learn more**: [Pairing with a Partner Who Forgets Everything](https://vieko.dev/sessions)
+
+---
+
+## Quick Start
+
+### 1. Start a Session
+
+Use the slash command:
+```
+/start-session
+```
+
+Or prompt Claude directly:
+> "Read .sessions/index.md and report when ready. Summarize the current state and ask what I want to work on."
+
+### 2. Work Together
+
+As you work, document important decisions, architecture choices, and progress:
+> "Add this to .sessions/index.md under Current State"
+> "Document this API decision in .sessions/"
+
+### 3. End the Session
+
+Use the slash command:
+```
+/end-session
+```
+
+Or prompt Claude directly:
+> "Update .sessions/index.md with what we accomplished this session. Include today's date, what we built, any decisions made, and next priorities. Then commit the changes."
+
+---
+
+## Workflow
+
+```
+┌─────────────────────────────────────────────────┐
+│ Start Session                                   │
+│ → Read .sessions/index.md                       │
+│ → Understand current context                    │
+│ → Ask what to work on                           │
+└─────────────────────────────────────────────────┘
+                     ↓
+┌─────────────────────────────────────────────────┐
+│ During Session                                  │
+│ → Build features                                │
+│ → Make decisions                                │
+│ → Document as you go                            │
+└─────────────────────────────────────────────────┘
+                     ↓
+┌─────────────────────────────────────────────────┐
+│ End Session                                     │
+│ → Update .sessions/index.md                     │
+│ → Record what happened                          │
+│ → Set next priorities                           │
+│ → Commit changes                                │
+└─────────────────────────────────────────────────┘
+```
+
+---
+
+## Slash Commands
+
+This setup includes three slash commands for Claude Code:
+
+### `/start-session`
+Reads your session context and gets you oriented. Claude will:
+- Load `.sessions/index.md`
+- Summarize current state
+- Ask what you want to work on
+
+### `/end-session`
+Updates your session context with what happened. Claude will:
+- Document accomplishments
+- Record decisions and blockers
+- Set next session priorities
+- Commit the changes
+
+### `/archive-session`
+Archives completed work to keep your context file clean. Claude will:
+- Move finished notes to `.sessions/archive/`
+- Clean up completed items from index.md
+
+---
+
+## Conversational Prompts
+
+Prefer typing to slash commands? Here are copy-paste prompts for each step:
+
+### Starting a Session
+```
+Read .sessions/index.md and report when ready.
+
+Summarize:
+- Current state
+- Recent work
+- Next priorities
+
+Then ask what I want to work on this session.
+```
+
+### During a Session
+```
+Document this in .sessions/ under [section name]
+```
+
+```
+Add this decision to .sessions/index.md: [your note]
+```
+
+### Ending a Session
+```
+Update .sessions/index.md with what we accomplished this session.
+
+Include:
+- Today's date
+- What we built/fixed/decided
+- Any blockers or open questions
+- Next session priorities
+
+Then commit the changes with a descriptive message.
+```
+
+### Archiving Work
+```
+Review completed work in .sessions/ and archive it.
+
+Move finished session notes to .sessions/archive/ organized by date or topic.
+Clean up .sessions/index.md by removing completed items.
+```
+
+---
+
+## Tips
+
+1. **Update frequently** - Don't wait until the end. Document decisions as you make them.
+
+2. **Be specific** - "Fixed auth bug" is less useful than "Fixed token refresh race condition in AuthProvider"
+
+3. **Track blockers** - Note what's blocking progress so the next session can pick up smoothly
+
+4. **Commit often** - Each session should have at least one commit updating `.sessions/index.md`
+
+5. **Archive completed work** - Once a feature is done, move detailed notes to `.sessions/archive/` to keep your index file scannable
+
+---
+
+## Customizing
+
+This structure is a starting point. Adapt it to your needs:
+
+- Add topic-specific docs (`.sessions/architecture.md`, `.sessions/api-decisions.md`)
+- Create templates for recurring documentation
+- Structure the archive however makes sense for your project
+- Modify slash commands in `.claude/commands/` to match your workflow
+
+---
+
+## Why This Works
+
+AI coding agents are stateless - they don't remember previous sessions. The Sessions Directory Pattern solves this by:
+
+1. **Externalizing memory** - Context lives in files, not the agent's "memory"
+2. **Progressive documentation** - You document as you build, not after
+3. **Continuity across sessions** - Each session starts with full context
+4. **Proof of decisions** - Everything is written down and committed
+
+Read the full story: [vieko.dev/sessions](https://vieko.dev/sessions)
+
+---
+
+**Questions or feedback?** Open an issue at [github.com/vieko/create-sessions-dir](https://github.com/vieko/create-sessions-dir)

package/templates/sessions/index.md

@@ -0,0 +1,41 @@
+# Session Context: {{PROJECT_NAME}}
+
+**Date**: {{CURRENT_DATE}}
+**Status**: Initial setup
+
+---
+
+## Current State
+
+This is your session context file. Update this document at the end of each session with:
+- What you're working on
+- Current progress
+- Any decisions made
+- Blockers or open questions
+
+---
+
+## Recent Sessions
+
+### Session 1 - {{CURRENT_DATE_2}}
+**Accomplished**:
+- Set up Sessions Directory Pattern
+- Created initial context file
+- Configured slash commands for Claude Code
+
+**Next**:
+- Start building!
+
+---
+
+## Next Session Priorities
+
+1. Define what you're building
+2. Document your architecture decisions
+3. Track progress here as you go
+
+---
+
+## Notes
+
+Add project-specific notes, links, or references here as needed.