{"id":44325965,"url":"https://github.com/zafrem/obsidian-role-switch","last_synced_at":"2026-02-11T07:34:56.148Z","repository":{"id":314576832,"uuid":"1055263547","full_name":"zafrem/obsidian-role-switch","owner":"zafrem","description":"This program is a tool that recognizes and makes task switching easier, even though multitasking is difficult.","archived":false,"fork":false,"pushed_at":"2026-02-06T05:52:41.000Z","size":9868,"stargazers_count":2,"open_issues_count":2,"forks_count":0,"subscribers_count":0,"default_branch":"main","last_synced_at":"2026-02-06T14:12:49.386Z","etag":null,"topics":["multitasking","obsidian-plugin","productivity-suite","switchtasking"],"latest_commit_sha":null,"homepage":"https://github.com/zafrem/obsidian-role-switch","language":"TypeScript","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/zafrem.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null,"notice":null,"maintainers":null,"copyright":null,"agents":"AGENTS.md","dco":null,"cla":null}},"created_at":"2025-09-12T02:42:14.000Z","updated_at":"2026-02-06T05:50:04.000Z","dependencies_parsed_at":"2025-09-13T12:12:05.709Z","dependency_job_id":"6cc862c2-e526-41e4-b5f2-a9b49c2a6d07","html_url":"https://github.com/zafrem/obsidian-role-switch","commit_stats":null,"previous_names":["zafrem/obsidian-taskswitch"],"tags_count":4,"template":false,"template_full_name":null,"purl":"pkg:github/zafrem/obsidian-role-switch","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/zafrem%2Fobsidian-role-switch","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/zafrem%2Fobsidian-role-switch/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/zafrem%2Fobsidian-role-switch/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/zafrem%2Fobsidian-role-switch/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/zafrem","download_url":"https://codeload.github.com/zafrem/obsidian-role-switch/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/zafrem%2Fobsidian-role-switch/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":29329493,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-02-11T06:13:03.264Z","status":"ssl_error","status_checked_at":"2026-02-11T06:12:55.843Z","response_time":97,"last_error":"SSL_read: unexpected eof while reading","robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":false,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["multitasking","obsidian-plugin","productivity-suite","switchtasking"],"created_at":"2026-02-11T07:34:56.041Z","updated_at":"2026-02-11T07:34:56.141Z","avatar_url":"https://github.com/zafrem.png","language":"TypeScript","funding_links":[],"categories":[],"sub_categories":[],"readme":"# RoleSwitch - Obsidian Plugin\n\nAn Obsidian plugin that helps you consciously switch between different work roles—like developer, writer, researcher, or QA—with intentional transitions and session tracking.\n\n\u003e **Why I built this**: I wear many hats throughout the day (developer, writer, researcher). This plugin helps me be intentional about which role I'm in and switch between them mindfully.\n\n## Demo\n[![Demo](./image/Demo.gif)](./image/Demo.gif)\n\n### Mobile Demo\n[![Demo1](./image/Demo1.gif)](./image/Demo1.gif)\n\n\n## Features\n\n### Core Features\n- **Custom Work Roles**: Define roles with unique colors and letter-based icons (A-Z)\n- **Intentional Transitions**: Configurable transition delays with educational messages about context switching\n- **Session Locks**: Minimum session duration prevents task-jumping and encourages deep focus\n- **Role Awareness**: Visual cues (status bar, workspace borders, colored UI) remind you which role you're in\n- **Session Tracking**: Track time spent in each role with real-time timers and historical data\n- **Analytics Dashboard**: View daily, weekly, and monthly time statistics\n\n### User Interface\n- **Side Panel View**: Quick access to all roles with real-time session tracking\n- **Role Dashboard**: Comprehensive analytics and session management\n- **Smart Settings**: Preset buttons + direct input fields for easy configuration\n- **Mobile Optimized**: Fully responsive design for mobile devices\n- **Visual Feedback**: Click animations and color-coded role indicators\n\n### Smart Features\n- **Periodic Reminders**: Optional notifications to keep you aware of your current role\n- **Real-time Updates**: Live countdown timers for session locks and durations\n- **Data Preservation**: Historical data retained even when roles are deleted (appears as \"Deleted Role\")\n- **Transition Messages**: Educational tips about context switching during role transitions\n- **Auto-save**: Data saved periodically and when app is backgrounded (mobile-friendly)\n\n## Use Cases \u0026 Examples\n\n### Solo Developer Workflow\nWhen you're wearing multiple hats on a project:\n\n**🔧 Developer Role**: Writing code, implementing features\n- Switch to Developer mode when coding\n- Track time spent on implementation vs other activities\n- Use role notes to capture technical decisions and code ideas\n\n**🔍 QA Role**: Testing, bug hunting, quality assurance\n- Switch to QA mode when testing your own code\n- Approach your work with a different mindset - looking for issues rather than building\n- Track testing time separately from development time\n- Document bugs and edge cases in role-specific notes\n\n**📋 Planning Role**: Architecture, project planning, requirements\n- Switch to Planning mode for high-level thinking\n- Step back from code details to see the bigger picture\n- Track time spent on strategic thinking vs tactical work\n\n### Content Creator Workflow\nFor writers, bloggers, and content creators:\n\n**✍️ Writer Role**: Creating first drafts, brainstorming content\n- Focus purely on getting ideas down without judgment\n- Track productive writing time vs editing time\n- Capture creative ideas in role-specific notes\n\n**📝 Editor Role**: Reviewing, refining, and polishing content\n- Switch mindset from creative to critical\n- Approach your own work objectively for better editing\n- Track revision time to understand your editing patterns\n\n**📊 Reviewer Role**: Final review, fact-checking, publishing prep\n- Final quality check with fresh perspective\n- Ensure consistency and accuracy before publication\n- Document review checklists and publishing notes\n\n### Research \u0026 Analysis Work\nFor researchers, analysts, and knowledge workers:\n\n**🔍 Researcher Role**: Gathering information, exploring topics\n- Deep dive into sources and materials\n- Track research time vs analysis time\n- Collect and organize findings in role notes\n\n**🧠 Analyst Role**: Processing information, drawing conclusions\n- Switch from gathering to synthesizing mode\n- Focus on patterns and insights rather than collection\n- Document analytical frameworks and methodologies\n\n**📊 Evaluator Role**: Reviewing findings, quality control\n- Step back to assess research quality and completeness\n- Challenge your own conclusions with fresh eyes\n- Track validation and review activities separately\n\n## Quick Start\n\n1. **Install**: Enable \"RoleSwitch\" in **Settings → Community plugins**\n2. **Setup**: Go to **Settings → RoleSwitch**\n   - Create your work roles (e.g., \"Developer\", \"Writer\", \"Researcher\")\n   - Choose letter icons (A-Z), colors, and descriptions\n   - Configure transition duration and minimum session duration\n3. **Access**: Open the RoleSwitch side panel from the left sidebar\n4. **Start**: Click on any role to begin a session\n5. **Switch**: When locked, wait for the minimum duration or use the transition modal\n6. **Track**: View your analytics in the Dashboard button\n\n## Settings Guide\n\n### Session Settings\n- **Transition duration**: Time to wait before switching roles (5-120 seconds)\n  - Presets: 5s, 10s, 30s or enter custom value\n- **Minimum session duration**: Minimum time before allowing role switches (5-60 minutes)\n  - Presets: 5m, 15m, 30m or enter custom value\n\n### Display Settings\n- **Show status bar**: Display current role in Obsidian status bar\n- **Show workspace border**: Visual border in role's color\n- **Border opacity**: Adjust border visibility (0.1-1.0)\n  - Presets: 0.3, 0.5, 0.8 or enter custom value\n- **Show periodic reminder**: Enable role reminders\n- **Reminder interval**: How often to show reminders (1-60 minutes)\n  - Presets: 5m, 15m, 30m or enter custom value\n\n## Documentation\n\n- **[Features](docs/FEATURES.md)** - Detailed feature overview\n- **[Installation](docs/INSTALLATION.md)** - Installation and setup guide\n- **[Usage](docs/USAGE.md)** - Interface guide and usage patterns\n- **[Troubleshooting](docs/TROUBLESHOOTING.md)** - Common issues and solutions\n- **[Development](docs/DEVELOPMENT.md)** - Contributing and technical details\n\n## Key UI Elements\n\n### Side Panel\n- **Header**: Shows plugin logo and title\n- **Roles Grid**: Click any role to start/switch sessions\n- **Current Session**: Real-time duration and lock status\n- **Quick Actions**: Dashboard and End Session buttons\n\n### Transition Modal\nWhen switching roles, you'll see:\n- Countdown timer\n- Educational message about context switching\n- Cancel button if needed\n\n### Role Dashboard\n- **Analytics**: Today, week, and month statistics\n- **Current Session**: Live tracking with lock countdown\n- **Averages**: Daily averages for week and month\n\n## Version Information\n\n- **Version**: 0.1.1\n- **Minimum Obsidian**: 1.6.0\n- **Platforms**: Windows, macOS, Linux, iOS, Android\n- **License**: MIT\n\n## Recent Updates\n\n### UI/UX Improvements\n- Letter-based icons (A-Z) for simpler role identification\n- Click highlight effects for better visual feedback\n- Improved icon selection with color toggle\n- End Session button always visible (disabled when locked)\n- Logo integration in side panel and dashboard\n\n### Feature Enhancements\n- Preset buttons + direct input for all settings\n- Unit labels for better clarity (seconds, minutes, opacity)\n- Transition messages with context switching education\n- Periodic reminders with customizable intervals\n- Real-time lock countdowns in multiple locations\n\n### Data \u0026 Stability\n- Auto-save on app backgrounding (mobile-friendly)\n- Historical data preserved when roles deleted\n- Error handling for save operations\n- Fixed mobile data persistence issues\n\n## Disabled Features\n\nThe following features are currently disabled in this version but remain in the codebase for future use:\n\n- **API \u0026 Synchronization Settings**: Combined API server and device synchronization functionality (will be enabled in a future version)\n\n---\n\n*Be intentional about your roles. Switch with purpose.*","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fzafrem%2Fobsidian-role-switch","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fzafrem%2Fobsidian-role-switch","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fzafrem%2Fobsidian-role-switch/lists"}