{"id":34879102,"url":"https://github.com/mudler/wiz","last_synced_at":"2026-01-24T23:16:44.006Z","repository":{"id":330496329,"uuid":"1114076303","full_name":"mudler/wiz","owner":"mudler","description":"The system shell for the AI era","archived":false,"fork":false,"pushed_at":"2026-01-15T21:24:38.000Z","size":133,"stargazers_count":3,"open_issues_count":2,"forks_count":2,"subscribers_count":1,"default_branch":"master","last_synced_at":"2026-01-20T23:22:39.089Z","etag":null,"topics":[],"latest_commit_sha":null,"homepage":"","language":"Go","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/mudler.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-10T21:39:28.000Z","updated_at":"2026-01-15T21:24:16.000Z","dependencies_parsed_at":null,"dependency_job_id":null,"html_url":"https://github.com/mudler/wiz","commit_stats":null,"previous_names":["mudler/wiz"],"tags_count":4,"template":false,"template_full_name":null,"purl":"pkg:github/mudler/wiz","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/mudler%2Fwiz","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/mudler%2Fwiz/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/mudler%2Fwiz/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/mudler%2Fwiz/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/mudler","download_url":"https://codeload.github.com/mudler/wiz/tar.gz/refs/heads/master","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/mudler%2Fwiz/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":28738980,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-01-24T22:12:27.248Z","status":"ssl_error","status_checked_at":"2026-01-24T22:12:10.529Z","response_time":89,"last_error":"SSL_connect returned=1 errno=0 peeraddr=140.82.121.6:443 state=error: 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":[],"created_at":"2025-12-26T01:39:13.661Z","updated_at":"2026-01-24T23:16:43.986Z","avatar_url":"https://github.com/mudler.png","language":"Go","funding_links":[],"categories":[],"sub_categories":[],"readme":"\u003ch1 align=\"center\"\u003e\n  \u003cbr\u003e\n  \u003cimg width=\"350\" alt=\"logo_wiz\" src=\"https://github.com/user-attachments/assets/7b234b54-c228-4c2f-8bcc-524a9dafd7b1\" /\u003e\n\u003cbr\u003e\n\u003c/h1\u003e\n\nFeeling Lazy? ask it to Wiz.\n\nWiz is a small assistant living in your terminal that can be invoked with CTRL+space.\n\nWiz aims to be the `fzf` for llms living in your terminal that is portable and local-llm friendly.\n\n\n\u003cp align=\"center\"\u003e\n  \u003ca href=\"#features\"\u003eFeatures\u003c/a\u003e •\n  \u003ca href=\"#installation\"\u003eInstallation\u003c/a\u003e •\n  \u003ca href=\"#usage\"\u003eUsage\u003c/a\u003e •\n  \u003ca href=\"#configuration\"\u003eConfiguration\u003c/a\u003e •\n  \u003ca href=\"#tool-approval\"\u003eTool Approval\u003c/a\u003e\n\u003c/p\u003e\n\n---\n\n## Features\n\n🧙 **Terminal Keybindings** — Press `Ctrl+Space` anywhere to summon the wizard\n\n⚡ **Dual modes** — Beautiful TUI or simple CLI, your choice\n\n🔧 **Tool execution** — AI runs shell commands with your approval\n\n✅ **Allow list** — Type `a` to trust a tool for the entire session\n\n🔌 **MCP Protocol** — Connect external AI tool servers\n\n📟 **Tmux support** — Seamless splits and popups\n\n🐚 **Multi-shell** — zsh, bash, and fish supported\n\n📦 **0 dependencies** — Portable, single binary, easy to install and upgrade\n\n\n## Installation\n\n### Quick Install\n\n```bash\ncurl -fsSL https://raw.githubusercontent.com/mudler/wiz/master/install.sh | bash\n```\n\nOr, if you use zsh:\n\n\n```bash\ncurl -fsSL https://raw.githubusercontent.com/mudler/wiz/master/install.sh | zsh\n```\n\n\n### From Source\n\n```bash\ngit clone https://github.com/mudler/wiz\ncd wiz\ngo build -o wiz .\nsudo mv wiz /usr/local/bin/\n```\n\n### Go Install\n\n```bash\ngo install github.com/mudler/wiz@latest\n```\n\n## Usage\n\nAfter installation, in your terminal, Press CTRL+Space to start `wiz.\n\nYou can also run wiz manually by running `wiz`.\n\n### Manually install Shell Integration\n\nAdd to your shell config to enable `Ctrl+Space` (only needed if you did not install with `install.sh` and want to have shell bindings):\n\n**zsh** (~/.zshrc):\n```bash\neval \"$(wiz --init zsh)\"\n```\n\n**bash** (~/.bashrc):\n```bash\neval \"$(wiz --init bash)\"\n```\n\n**fish** (~/.config/fish/config.fish):\n```fish\nwiz --init fish | source\n```\n\nNow `wiz` will be ready when you press `Ctrl+Space` anywhere in your terminal!\n\n## Configuration\n\nCreate a config file at `~/.config/wiz/config.yaml`, `~/.wiz.yaml` or at `/etc/wiz/config.yaml` for global settings:\n\n```yaml\n# Required: Your LLM configuration\nmodel: gpt-4o-mini\napi_key: your-api-key\nbase_url: https://api.openai.com/v1\n\n# Optional: Custom system prompt\nprompt: |\n  You are a helpful terminal wizard...\n\n# Optional: Agent behavior\nagent_options:\n  iterations: 10\n  max_attempts: 3\n  max_retries: 3\n  force_reasoning: false\n\n# Optional: Additional MCP servers\nmcp_servers:\n  filesystem:\n    command: npx\n    args:\n      - \"-y\"\n      - \"@anthropic/mcp-filesystem\"\n      - \"/home/user\"\n    env:\n      foo: bar\n```\n\n### Environment Variables\n\nYou can also configure via environment variables:\n\n```bash\nexport MODEL=gpt-4o-mini\nexport API_KEY=your-api-key\nexport BASE_URL=https://api.openai.com/v1\n```\n\n## Tool Approval\n\nWhen the wizard wants to run a command, you'll see a prompt:\n\n```\n┌──────────────────────────────────────┐\n│ 🔧 bash                              │\n│                                      │\n│ Arguments: {\"script\": \"ls -la\"}      │\n│ 💭 Listing directory contents...     │\n│                                      │\n│ [y]es  [a]lways  [n]o  or adjust     │\n└──────────────────────────────────────┘\n```\n\n**Options:**\n- `y` or `yes` — Approve this execution\n- `a` or `always` — Approve and add to session allow list (won't ask again)\n- `n` or `no` — Deny execution\n- *anything else* — Treated as an adjustment to the command\n\n## MCP Servers\n\nWiz uses the [Model Context Protocol](https://modelcontextprotocol.io/) for tool execution.\n\n### Built-in Tools\n\n- **bash** — Execute shell scripts\n\n### Adding External MCP Servers\n\nAdd to your config:\n\n```yaml\nmcp_servers:\n  my_server:\n    command: /path/to/mcp-server\n    args:\n      - --some-flag\n    env:\n      API_KEY: secret\n```\n\n## Tmux Integration\n\nWhen running inside tmux, wiz automatically uses a split pane for the TUI. Use `--no-tmux` to disable this behavior.\n\n## License\n\nMIT\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fmudler%2Fwiz","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fmudler%2Fwiz","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fmudler%2Fwiz/lists"}