{"id":33918674,"url":"https://github.com/bkataru/stuckbar","last_synced_at":"2026-01-13T22:01:33.572Z","repository":{"id":327468478,"uuid":"1109440102","full_name":"bkataru/stuckbar","owner":"bkataru","description":"straightforward CLI tool \u0026 MCP server for getting that annoying Windows taskbar unstuck","archived":false,"fork":false,"pushed_at":"2025-12-05T07:52:44.000Z","size":64,"stargazers_count":0,"open_issues_count":0,"forks_count":0,"subscribers_count":0,"default_branch":"main","last_synced_at":"2025-12-13T14:39:09.156Z","etag":null,"topics":["cli","rust","stuck","taskbar","windows"],"latest_commit_sha":null,"homepage":"https://crates.io/crates/stuckbar","language":"Rust","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/bkataru.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":null,"dco":null,"cla":null}},"created_at":"2025-12-03T20:05:59.000Z","updated_at":"2025-12-05T07:52:47.000Z","dependencies_parsed_at":null,"dependency_job_id":null,"html_url":"https://github.com/bkataru/stuckbar","commit_stats":null,"previous_names":["bkataru/stuckbar"],"tags_count":0,"template":false,"template_full_name":null,"purl":"pkg:github/bkataru/stuckbar","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/bkataru%2Fstuckbar","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/bkataru%2Fstuckbar/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/bkataru%2Fstuckbar/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/bkataru%2Fstuckbar/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/bkataru","download_url":"https://codeload.github.com/bkataru/stuckbar/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/bkataru%2Fstuckbar/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":28400398,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-01-13T14:36:09.778Z","status":"ssl_error","status_checked_at":"2026-01-13T14:35:19.697Z","response_time":56,"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":["cli","rust","stuck","taskbar","windows"],"created_at":"2025-12-12T08:29:51.348Z","updated_at":"2026-01-13T22:01:33.566Z","avatar_url":"https://github.com/bkataru.png","language":"Rust","funding_links":[],"categories":[],"sub_categories":[],"readme":"# stuckbar\n\n[![Crates.io](https://img.shields.io/crates/v/stuckbar.svg)](https://crates.io/crates/stuckbar)\n[![Documentation](https://docs.rs/stuckbar/badge.svg)](https://docs.rs/stuckbar)\n[![CI](https://github.com/bkataru/stuckbar/actions/workflows/ci.yml/badge.svg)](https://github.com/bkataru/stuckbar/actions/workflows/ci.yml)\n[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)\n\nA straightforward CLI tool \u0026 MCP server for getting that annoying Windows taskbar unstuck.\n\nWhen the Windows taskbar gets stuck (especially when configured to auto-hide), this utility provides a quick way to restart `explorer.exe` from the command line or via MCP tool calls, snapping the taskbar back to normal.\n\n\u003e **🪟 Windows Only**: This tool is designed specifically for Windows and will not work on macOS or Linux.\n\n## Installation\n\n### Using cargo (recommended)\n\n```bash\n# Basic installation (CLI only)\ncargo install stuckbar\n\n# With MCP server support (STDIO transport)\ncargo install stuckbar --features mcp\n\n# With full MCP support (STDIO + HTTP transports)\ncargo install stuckbar --features mcp-full\n```\n\n### From source\n\n```bash\ngit clone https://github.com/bkataru/stuckbar.git\ncd stuckbar\ncargo install --path .\n\n# Or with MCP features\ncargo install --path . --features mcp-full\n```\n\n## Usage\n\n### Basic CLI Usage\n\n```bash\n# Restart explorer.exe (default action)\nstuckbar\n\n# Or explicitly use the restart command\nstuckbar restart\n\n# Just kill explorer.exe\nstuckbar kill\n\n# Just start explorer.exe\nstuckbar start\n\n# Show help\nstuckbar --help\n\n# Show version\nstuckbar --version\n```\n\n### Commands\n\n| Command   | Description                              |\n|-----------|------------------------------------------|\n| `restart` | Kill and restart explorer.exe (default)  |\n| `kill`    | Terminate explorer.exe process           |\n| `start`   | Start explorer.exe process               |\n| `serve`   | Start MCP server (requires `mcp` feature)|\n\n## MCP Server (AI Agent Integration)\n\nStuckbar can run as a [Model Context Protocol (MCP)](https://modelcontextprotocol.io/) server, allowing AI agents to programmatically control Windows Explorer operations.\n\n### Features\n\nWhen running as an MCP server, stuckbar exposes three tools:\n\n| Tool               | Description                                           |\n|--------------------|-------------------------------------------------------|\n| `kill_explorer`    | Terminate the explorer.exe process                    |\n| `start_explorer`   | Start the explorer.exe process                        |\n| `restart_explorer` | Restart explorer.exe (recommended for stuck taskbar)  |\n\n### Running the MCP Server\n\n#### STDIO Transport (for direct process communication)\n\n```bash\n# Requires: cargo install stuckbar --features mcp\nstuckbar serve --stdio\n```\n\nThis is the recommended transport for most MCP clients like Claude Desktop.\n\n#### HTTP Transport (SSE-based, for network communication)\n\n```bash\n# Requires: cargo install stuckbar --features mcp-full\nstuckbar serve --http\n\n# With custom host and port\nstuckbar serve --http --host 0.0.0.0 --port 3000\n```\n\nThe HTTP server uses Server-Sent Events (SSE) and exposes:\n- SSE endpoint: `http://\u003chost\u003e:\u003cport\u003e/sse`\n- Message endpoint: `http://\u003chost\u003e:\u003cport\u003e/message`\n\n### Configuration Examples\n\n#### Claude Desktop\n\nAdd to your `claude_desktop_config.json`:\n\n**Windows:**\n```json\n{\n  \"mcpServers\": {\n    \"stuckbar\": {\n      \"command\": \"stuckbar\",\n      \"args\": [\"serve\", \"--stdio\"]\n    }\n  }\n}\n```\n\nOr with full path:\n```json\n{\n  \"mcpServers\": {\n    \"stuckbar\": {\n      \"command\": \"C:\\\\Users\\\\\u003cusername\u003e\\\\.cargo\\\\bin\\\\stuckbar.exe\",\n      \"args\": [\"serve\", \"--stdio\"]\n    }\n  }\n}\n```\n\n#### Other MCP Clients\n\nFor clients that support SSE transport:\n```bash\nstuckbar serve --http --port 8080\n# Connect to: http://localhost:8080/sse\n```\n\n## Feature Flags\n\n| Feature    | Description                                          |\n|------------|------------------------------------------------------|\n| (default)  | Basic CLI functionality                              |\n| `mcp`      | MCP server with STDIO transport                      |\n| `mcp-http` | MCP server with SSE HTTP transport (includes `mcp`)  |\n| `mcp-full` | All MCP features (alias for `mcp-http`)              |\n\n## Building from Source\n\n```bash\n# Clone the repository\ngit clone https://github.com/bkataru/stuckbar.git\ncd stuckbar\n\n# Build with default features\ncargo build --release\n\n# Build with MCP support\ncargo build --release --features mcp-full\n\n# Run tests\ncargo test\n\n# Run tests with all features\ncargo test --all-features\n```\n\n## How It Works\n\nWhen the Windows taskbar becomes unresponsive or stuck (often happens with auto-hide enabled), the typical fix is to restart Windows Explorer. This tool automates that process by:\n\n1. **Kill**: Forcefully terminating `explorer.exe` using `taskkill /F /IM explorer.exe`\n2. **Wait**: Pausing briefly (500ms) to ensure the process is fully terminated\n3. **Start**: Launching a new instance of `explorer.exe`\n\nThis restores the taskbar, desktop icons, and file explorer functionality.\n\n## Platform Support\n\nThis tool is **Windows-only**. Running on macOS or Linux will display an error message:\n\n```\nstuckbar is a Windows-only tool.\nCurrent platform 'linux' is not supported.\nThis tool restarts explorer.exe which only exists on Windows.\n```\n\n## License\n\nMIT License - see [LICENSE](LICENSE) for details.\n\n## Contributing\n\nContributions are welcome! Please feel free to submit a Pull Request :)\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fbkataru%2Fstuckbar","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fbkataru%2Fstuckbar","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fbkataru%2Fstuckbar/lists"}