workon 1.0.0 → 1.2.0

package/.cursorindexingignore

@@ -0,0 +1,3 @@
+
+# Don't index SpecStory auto-save files, but allow explicit context inclusion via @ references
+.specstory/**

package/.history/package_20250806214300.json

@@ -0,0 +1,42 @@
+{
+  "name": "workon",
+  "version": "1.1.0",
+  "description": "Work on something great!",
+  "main": "index.js",
+  "scripts": {
+    "release": "standard-version"
+  },
+  "repository": {
+    "type": "git",
+    "url": "git+ssh://git@github.com/israelroldan/workon.git"
+  },
+  "keywords": [
+    "productivity"
+  ],
+  "author": "Israel Roldan (me@isro.me)",
+  "license": "MIT",
+  "devDependencies": {
+    "cz-conventional-changelog": "^2.0.0",
+    "standard-version": "^4.2.0"
+  },
+  "config": {
+    "commitizen": {
+      "path": "./node_modules/cz-conventional-changelog"
+    }
+  },
+  "dependencies": {
+    "conf": "^1.1.2",
+    "deep-assign": "^2.0.0",
+    "flat": "^2.0.1",
+    "inquirer": "^3.1.1",
+    "loog": "^1.4.0",
+    "omelette": "^0.4.4",
+    "openurl2": "^1.0.1",
+    "phylo": "^1.0.0-beta.7",
+    "simple-git": "^1.73.0",
+    "switchit": "^1.0.7"
+  },
+  "bin": {
+    "workon": "bin/workon"
+  }
+}

package/.history/package_20250806215528.json

@@ -0,0 +1,43 @@
+{
+  "name": "workon",
+  "version": "1.1.0",
+  "description": "Work on something great!",
+  "main": "index.js",
+  "scripts": {
+    "release": "standard-version"
+  },
+  "repository": {
+    "type": "git",
+    "url": "git+ssh://git@github.com/israelroldan/workon.git"
+  },
+  "keywords": [
+    "productivity"
+  ],
+  "author": "Israel Roldan (me@isro.me)",
+  "license": "MIT",
+  "devDependencies": {
+    "cz-conventional-changelog": "^2.0.0",
+    "standard-version": "^4.2.0"
+  },
+  "config": {
+    "commitizen": {
+      "path": "./node_modules/cz-conventional-changelog"
+    }
+  },
+  "dependencies": {
+    "conf": "^1.1.2",
+    "deep-assign": "^2.0.0",
+    "flat": "^2.0.1",
+    "inquirer": "^3.1.1",
+    "loog": "^1.4.0",
+    "omelette": "^0.4.4",
+    "openurl2": "^1.0.1",
+    "phylo": "^1.0.0-beta.7",
+    "simple-git": "^1.73.0",
+    "switchit": "^1.0.7"
+  },
+  "bin": {
+    "workon": "bin/workon",
+    "wo": "bin/workon"
+  }
+}

package/.vscode/terminals.json

@@ -0,0 +1,11 @@
+{
+  "autorun": true,
+  "artificialDelay": 1000,
+  "terminals": [
+    {
+      "name": "Persistent",
+      "focus": true,
+      "command": "cc"
+    }
+  ]
+}

package/CHANGELOG.md

@@ -2,6 +2,32 @@
 
 All notable changes to this project will be documented in this file. See [standard-version](https://github.com/conventional-changelog/standard-version) for commit guidelines.
 
+<a name="1.2.0"></a>
+# [1.2.0](https://github.com/israelroldan/workon/compare/v1.1.0...v1.2.0) (2025-08-06)
+
+
+### Features
+
+* Introduce interactive project management feature ([3157e27](https://github.com/israelroldan/workon/commit/3157e27))
+
+
+
+<a name="1.1.0"></a>
+# [1.1.0](https://github.com/israelroldan/workon/compare/v1.0.0...v1.1.0) (2025-08-06)
+
+
+### Bug Fixes
+
+* Update package.json format for npm publish ([6c5e9e0](https://github.com/israelroldan/workon/commit/6c5e9e0))
+
+
+### Features
+
+* Enhance CLI with new 'claude' command support ([70b3f96](https://github.com/israelroldan/workon/commit/70b3f96))
+* Improve shell integration for workon command ([f5b6ff0](https://github.com/israelroldan/workon/commit/f5b6ff0))
+
+
+
 <a name="1.0.0-alpha.1"></a>
 # [1.0.0-alpha.1](https://code.palu.io/israel/workon/compare/v1.0.0-alpha.0...v1.0.0-alpha.1) (2017-06-26)
 

package/cli/index.js

@@ -8,6 +8,7 @@ const {EnvironmentRecognizer} = require('../lib/environment');
 const config = require('./config');
 const interactive = require('./interactive');
 const open = require('./open');
+const manage = require('./manage');
 
 class workon extends container {
     constructor (log) {
@@ -83,15 +84,46 @@ class workon extends container {
 
     outputShellInit () {
         let me = this;
+        
+        // Get list of available commands from switchit
+        let cmdNames = me.constructor.getAspects().commands.filter((c) => !!c).map((c) => c.name);
+        
+        // Get list of available switches from switchit
+        let switches = me.constructor.getAspects().switches || [];
+        let switchFlags = [];
+        switches.forEach(sw => {
+            switchFlags.push('--' + sw.name);
+            if (sw.char) {
+                switchFlags.push('-' + sw.char);
+            }
+        });
+        
+        // Add built-in switchit flags (help and version are automatically added by switchit)
+        let builtinFlags = ['--help', '-h', '--version', '-v', 'help'];
+        
+        // Combine all non-shell commands and flags, removing duplicates
+        let nonShellCommands = [...new Set(cmdNames.concat(switchFlags).concat(builtinFlags))];
+        let casePattern = nonShellCommands.join('|');
+        
         // Generate shell function that wraps workon calls
         let shellFunction = `
 # workon shell integration
 workon() {
-    if [[ "$1" == "--init" ]]; then
+    # Commands and flags that should NOT use shell mode
+    case "$1" in
+        ${casePattern})
+            command workon "$@"
+            return $?
+            ;;
+    esac
+    
+    # If no arguments provided, run interactive mode directly
+    if [[ $# -eq 0 ]]; then
         command workon "$@"
         return $?
     fi
     
+    # Default behavior: use shell mode for project opening
     local output
     output=$(command workon --shell "$@" 2>&1)
     local exit_code=$?
@@ -144,7 +176,8 @@ workon.define({
             private: true
         },
         open,
-        config
+        config,
+        manage
     }
 });
 

package/cli/manage.js

@@ -0,0 +1,381 @@
+const { command } = require('./base');
+const inquirer = require('inquirer');
+const File = require('phylo');
+const ProjectValidator = require('../lib/validation');
+const path = require('path');
+
+class manage extends command {
+    execute(params) {
+        let me = this;
+        me.validator = new ProjectValidator(me.config);
+        me.showLogo();
+        return me.startManagement();
+    }
+
+    showLogo() {
+        let me = this;
+        let version = me.config.get('pkg').version;
+
+        if (!this._hasShownLogo) {
+            this.log.log(`                      8\u001b[2m${' '.repeat(Math.max(15-version.length-1, 1))+'v'+version}\u001b[22m\nYb  db  dP .d8b. 8d8b 8.dP \u001b[92m.d8b. 8d8b.\u001b[0m\n YbdPYbdP  8' .8 8P   88b  \u001b[92m8' .8 8P Y8\u001b[0m\n  YP  YP   \`Y8P' 8    8 Yb \u001b[92m\`Y8P' 8   8\u001b[0m`);
+            this._hasShownLogo = true;
+        }
+    }
+
+    async startManagement() {
+        let me = this;
+        const projects = me.config.get('projects') || {};
+        const projectNames = Object.keys(projects);
+
+        const mainMenu = {
+            type: 'list',
+            name: 'action',
+            message: 'Project Management',
+            choices: [
+                {
+                    name: 'Create new project',
+                    value: 'create'
+                },
+                ...(projectNames.length > 0 ? [
+                    {
+                        name: 'Edit existing project',
+                        value: 'edit'
+                    },
+                    {
+                        name: 'Delete project',
+                        value: 'delete'
+                    },
+                    {
+                        name: 'List all projects',
+                        value: 'list'
+                    }
+                ] : []),
+                new inquirer.Separator(),
+                {
+                    name: 'Exit',
+                    value: 'exit'
+                }
+            ]
+        };
+
+        const answer = await inquirer.prompt([mainMenu]);
+
+        switch (answer.action) {
+            case 'create':
+                return me.createProject();
+            case 'edit':
+                return me.editProject();
+            case 'delete':
+                return me.deleteProject();
+            case 'list':
+                return me.listProjects();
+            case 'exit':
+                return;
+        }
+    }
+
+    async createProject() {
+        let me = this;
+        const defaults = me.config.get('project_defaults') || {};
+        const projects = me.config.get('projects') || {};
+
+        me.log.log('\n🚀 Create New Project\n');
+
+        const questions = [
+            {
+                type: 'input',
+                name: 'name',
+                message: 'Project name:',
+                default: File.cwd().name,
+                validate: (value) => me.validator.validateProjectName(value, projects)
+            },
+            {
+                type: 'input',
+                name: 'path',
+                message: 'Project path (relative to base directory):',
+                default: (answers) => answers.name,
+                validate: (value) => {
+                    const basePath = defaults.base || process.cwd();
+                    return me.validator.validateProjectPath(value, basePath);
+                }
+            },
+            {
+                type: 'list',
+                name: 'ide',
+                message: 'IDE/Editor:',
+                choices: [
+                    { name: 'Visual Studio Code', value: 'code' },
+                    { name: 'IntelliJ IDEA', value: 'idea' },
+                    { name: 'Atom', value: 'atom' },
+                    { name: 'Sublime Text', value: 'subl' },
+                    { name: 'Vim', value: 'vim' },
+                    { name: 'Emacs', value: 'emacs' }
+                ],
+                default: defaults.ide || 'code'
+            },
+            {
+                type: 'input',
+                name: 'homepage',
+                message: 'Project homepage (optional):',
+                validate: (value) => me.validator.validateUrl(value)
+            },
+            {
+                type: 'checkbox',
+                name: 'events',
+                message: 'Select events to enable:',
+                choices: [
+                    { name: 'Change directory (cwd)', value: 'cwd', checked: true },
+                    { name: 'Open in IDE', value: 'ide', checked: true },
+                    { name: 'Open homepage in browser', value: 'web' },
+                    { name: 'Launch Claude Code', value: 'claude' }
+                ]
+            }
+        ];
+
+        const answers = await inquirer.prompt(questions);
+
+        // Convert events array to object
+        const events = {};
+        answers.events.forEach(event => {
+            events[event] = 'true';
+        });
+
+        const projectConfig = {
+            path: answers.path,
+            ide: answers.ide,
+            events: events
+        };
+
+        if (answers.homepage) {
+            projectConfig.homepage = answers.homepage;
+        }
+
+        const confirm = await inquirer.prompt([{
+            type: 'confirm',
+            name: 'confirmed',
+            message: 'Create this project?',
+            default: true
+        }]);
+
+        if (confirm.confirmed) {
+            projects[answers.name] = projectConfig;
+            me.config.set('projects', projects);
+            me.log.log(`\n✅ Project '${answers.name}' created successfully!`);
+        }
+
+        const continuePrompt = await inquirer.prompt([{
+            type: 'confirm',
+            name: 'continue',
+            message: 'Return to main menu?',
+            default: true
+        }]);
+
+        if (continuePrompt.continue) {
+            return me.startManagement();
+        }
+    }
+
+    async editProject() {
+        let me = this;
+        const projects = me.config.get('projects') || {};
+        const projectNames = Object.keys(projects);
+
+        if (projectNames.length === 0) {
+            me.log.log('No projects found.');
+            return me.startManagement();
+        }
+
+        const projectChoice = await inquirer.prompt([{
+            type: 'list',
+            name: 'projectName',
+            message: 'Select project to edit:',
+            choices: projectNames.map(name => ({
+                name: `${name} (${projects[name].path})`,
+                value: name
+            }))
+        }]);
+
+        const project = projects[projectChoice.projectName];
+        const currentEvents = Object.keys(project.events || {}).filter(key => project.events[key] === 'true');
+
+        me.log.log(`\n✏️  Edit Project: ${projectChoice.projectName}\n`);
+
+        const questions = [
+            {
+                type: 'input',
+                name: 'path',
+                message: 'Project path:',
+                default: project.path,
+                validate: (value) => {
+                    const defaults = me.config.get('project_defaults') || {};
+                    const basePath = defaults.base || process.cwd();
+                    return me.validator.validateProjectPath(value, basePath);
+                }
+            },
+            {
+                type: 'list',
+                name: 'ide',
+                message: 'IDE/Editor:',
+                choices: [
+                    { name: 'Visual Studio Code', value: 'code' },
+                    { name: 'IntelliJ IDEA', value: 'idea' },
+                    { name: 'Atom', value: 'atom' },
+                    { name: 'Sublime Text', value: 'subl' },
+                    { name: 'Vim', value: 'vim' },
+                    { name: 'Emacs', value: 'emacs' }
+                ],
+                default: project.ide || 'code'
+            },
+            {
+                type: 'input',
+                name: 'homepage',
+                message: 'Project homepage:',
+                default: project.homepage || '',
+                validate: (value) => me.validator.validateUrl(value)
+            },
+            {
+                type: 'checkbox',
+                name: 'events',
+                message: 'Select events to enable:',
+                choices: [
+                    { name: 'Change directory (cwd)', value: 'cwd', checked: currentEvents.includes('cwd') },
+                    { name: 'Open in IDE', value: 'ide', checked: currentEvents.includes('ide') },
+                    { name: 'Open homepage in browser', value: 'web', checked: currentEvents.includes('web') },
+                    { name: 'Launch Claude Code', value: 'claude', checked: currentEvents.includes('claude') }
+                ]
+            }
+        ];
+
+        const answers = await inquirer.prompt(questions);
+
+        // Convert events array to object
+        const events = {};
+        answers.events.forEach(event => {
+            events[event] = 'true';
+        });
+
+        const updatedProject = {
+            path: answers.path,
+            ide: answers.ide,
+            events: events
+        };
+
+        if (answers.homepage) {
+            updatedProject.homepage = answers.homepage;
+        }
+
+        const confirm = await inquirer.prompt([{
+            type: 'confirm',
+            name: 'confirmed',
+            message: 'Save changes?',
+            default: true
+        }]);
+
+        if (confirm.confirmed) {
+            projects[projectChoice.projectName] = updatedProject;
+            me.config.set('projects', projects);
+            me.log.log(`\n✅ Project '${projectChoice.projectName}' updated successfully!`);
+        }
+
+        const continuePrompt = await inquirer.prompt([{
+            type: 'confirm',
+            name: 'continue',
+            message: 'Return to main menu?',
+            default: true
+        }]);
+
+        if (continuePrompt.continue) {
+            return me.startManagement();
+        }
+    }
+
+    async deleteProject() {
+        let me = this;
+        const projects = me.config.get('projects') || {};
+        const projectNames = Object.keys(projects);
+
+        if (projectNames.length === 0) {
+            me.log.log('No projects found.');
+            return me.startManagement();
+        }
+
+        const projectChoice = await inquirer.prompt([{
+            type: 'list',
+            name: 'projectName',
+            message: 'Select project to delete:',
+            choices: projectNames.map(name => ({
+                name: `${name} (${projects[name].path})`,
+                value: name
+            }))
+        }]);
+
+        const confirm = await inquirer.prompt([{
+            type: 'confirm',
+            name: 'confirmed',
+            message: `Are you sure you want to delete '${projectChoice.projectName}'?`,
+            default: false
+        }]);
+
+        if (confirm.confirmed) {
+            delete projects[projectChoice.projectName];
+            me.config.set('projects', projects);
+            me.log.log(`\n✅ Project '${projectChoice.projectName}' deleted successfully!`);
+        }
+
+        const continuePrompt = await inquirer.prompt([{
+            type: 'confirm',
+            name: 'continue',
+            message: 'Return to main menu?',
+            default: true
+        }]);
+
+        if (continuePrompt.continue) {
+            return me.startManagement();
+        }
+    }
+
+    async listProjects() {
+        let me = this;
+        const projects = me.config.get('projects') || {};
+        const projectNames = Object.keys(projects);
+
+        if (projectNames.length === 0) {
+            me.log.log('No projects found.');
+            return me.startManagement();
+        }
+
+        me.log.log('\n📋 All Projects:\n');
+
+        projectNames.forEach(name => {
+            const project = projects[name];
+            const events = Object.keys(project.events || {}).filter(key => project.events[key] === 'true');
+            
+            me.log.log(`${name}:`);
+            me.log.log(`  Path: ${project.path}`);
+            me.log.log(`  IDE: ${project.ide}`);
+            if (project.homepage) {
+                me.log.log(`  Homepage: ${project.homepage}`);
+            }
+            me.log.log(`  Events: ${events.join(', ') || 'none'}`);
+            me.log.log('');
+        });
+
+        const continuePrompt = await inquirer.prompt([{
+            type: 'confirm',
+            name: 'continue',
+            message: 'Return to main menu?',
+            default: true
+        }]);
+
+        if (continuePrompt.continue) {
+            return me.startManagement();
+        }
+    }
+}
+
+manage.define({
+    help: 'Interactive project management',
+    switches: '[d#debug:boolean=false] [h#help:boolean=false]'
+});
+
+module.exports = manage;

package/cli/open.js

@@ -125,6 +125,16 @@ class open extends command {
                         }
                     }
                 break;
+                case 'claude':
+                    if (isShellMode) {
+                        me.shellCommands.push(`claude &`);
+                    } else {
+                        spawn('claude', [], {
+                            cwd: environment.project.path.path,
+                            stdio: 'inherit'
+                        });
+                    }
+                break;
             }
         }
         if (`before${capitalEvt}` in scripts) {

package/docs/ideas.md

@@ -0,0 +1,49 @@
+# Ideas for workon
+
+This document contains ideas for future enhancements to the workon project.
+
+## Interactive Project Management
+
+### Project Configuration Editor
+Create an interactive mode for editing project configurations through guided prompts instead of manual file editing.
+
+**Features:**
+- Interactive project creation wizard with step-by-step guidance
+- Edit existing project properties (name, path, IDE, events) through prompts
+- Validate project paths and IDE commands during configuration
+- Preview configuration changes before saving
+- Bulk operations for managing multiple projects
+
+**Implementation considerations:**
+- Extend existing inquirer-based interactive system
+- Add new command like `workon config` or `workon manage --interactive`
+- Provide different flows for:
+  - Creating new projects
+  - Editing existing projects
+  - Bulk project management
+- Include validation for:
+  - Directory paths existence
+  - IDE command availability
+  - Event configuration correctness
+
+**Benefits:**
+- Lower barrier to entry for new users
+- Reduced configuration errors through validation
+- More discoverable project management features
+- Better UX compared to manual JSON editing
+
+## Enhanced Events
+
+### Advanced claude Event Options
+Extend the claude event with more configuration options:
+```json
+"claude": {
+  "mode": "interactive",
+  "flags": ["--resume"],
+  "project_context": true
+}
+```
+
+## Future Ideas
+
+*Add more ideas here as they come up...*

package/lib/validation.js

@@ -0,0 +1,104 @@
+const File = require('phylo');
+const { spawn } = require('child_process');
+const path = require('path');
+
+class ProjectValidator {
+    constructor(config) {
+        this.config = config;
+    }
+
+    validateProjectName(name, existingProjects = {}) {
+        if (!name || name.trim() === '') {
+            return 'Project name cannot be empty';
+        }
+        
+        if (name in existingProjects) {
+            return 'Project already exists';
+        }
+        
+        if (!/^[a-zA-Z0-9_-]+$/.test(name)) {
+            return 'Project name can only contain letters, numbers, underscores, and hyphens';
+        }
+        
+        return true;
+    }
+
+    validateProjectPath(projectPath, basePath) {
+        if (!projectPath || projectPath.trim() === '') {
+            return 'Project path cannot be empty';
+        }
+        
+        const fullPath = basePath ? path.resolve(basePath, projectPath) : path.resolve(projectPath);
+        
+        try {
+            const fileObj = new File(fullPath);
+            if (!fileObj.exists) {
+                return `Directory does not exist: ${fullPath}`;
+            }
+            if (!fileObj.isDirectory) {
+                return `Path is not a directory: ${fullPath}`;
+            }
+        } catch (error) {
+            return `Invalid path: ${error.message}`;
+        }
+        
+        return true;
+    }
+
+    validateIdeCommand(ideCommand) {
+        if (!ideCommand || ideCommand.trim() === '') {
+            return 'IDE command cannot be empty';
+        }
+
+        const validIdeCommands = ['code', 'idea', 'atom', 'subl', 'vim', 'emacs'];
+        if (!validIdeCommands.includes(ideCommand)) {
+            return `Unknown IDE command. Supported: ${validIdeCommands.join(', ')}`;
+        }
+
+        return true;
+    }
+
+    async validateIdeAvailability(ideCommand) {
+        return new Promise((resolve) => {
+            const child = spawn('which', [ideCommand], { stdio: 'pipe' });
+            child.on('close', (code) => {
+                if (code === 0) {
+                    resolve(true);
+                } else {
+                    resolve(`IDE command '${ideCommand}' not found in PATH`);
+                }
+            });
+            child.on('error', () => {
+                resolve(`Could not check if '${ideCommand}' is available`);
+            });
+        });
+    }
+
+    validateEvents(events) {
+        if (!events || typeof events !== 'object') {
+            return 'Events must be an object';
+        }
+
+        const validEvents = ['cwd', 'ide', 'web', 'claude'];
+        const invalidEvents = Object.keys(events).filter(event => !validEvents.includes(event));
+        
+        if (invalidEvents.length > 0) {
+            return `Invalid events: ${invalidEvents.join(', ')}. Valid events: ${validEvents.join(', ')}`;
+        }
+
+        return true;
+    }
+
+    validateUrl(url) {
+        if (!url) return true; // Optional field
+        
+        try {
+            new URL(url);
+            return true;
+        } catch {
+            return 'Invalid URL format';
+        }
+    }
+}
+
+module.exports = ProjectValidator;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "workon",
-  "version": "1.0.0",
+  "version": "1.2.0",
   "description": "Work on something great!",
   "main": "index.js",
   "scripts": {
@@ -37,6 +37,7 @@
     "switchit": "^1.0.7"
   },
   "bin": {
-    "workon": "bin/workon"
+    "workon": "bin/workon",
+    "wo": "bin/workon"
   }
 }