{"id":48459138,"url":"https://github.com/64bit/commandok","last_synced_at":"2026-04-20T00:14:30.324Z","repository":{"id":349078085,"uuid":"1200855355","full_name":"64bit/commandOK","owner":"64bit","description":"Spotlight-like command generator for your terminal. Pops up when you need it and gets out of the way when you don't.","archived":false,"fork":false,"pushed_at":"2026-04-04T04:13:47.000Z","size":314,"stargazers_count":1,"open_issues_count":0,"forks_count":0,"subscribers_count":0,"default_branch":"main","last_synced_at":"2026-04-04T06:11:43.728Z","etag":null,"topics":[],"latest_commit_sha":null,"homepage":"https://crates.io/crates/commandok","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/64bit.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":"2026-04-03T22:53:19.000Z","updated_at":"2026-04-04T06:02:56.000Z","dependencies_parsed_at":null,"dependency_job_id":null,"html_url":"https://github.com/64bit/commandOK","commit_stats":null,"previous_names":["64bit/commandok"],"tags_count":2,"template":false,"template_full_name":null,"purl":"pkg:github/64bit/commandOK","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/64bit%2FcommandOK","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/64bit%2FcommandOK/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/64bit%2FcommandOK/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/64bit%2FcommandOK/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/64bit","download_url":"https://codeload.github.com/64bit/commandOK/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/64bit%2FcommandOK/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":31495466,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-04-06T17:22:55.647Z","status":"ssl_error","status_checked_at":"2026-04-06T17:22:54.741Z","response_time":112,"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":[],"created_at":"2026-04-07T01:01:03.012Z","updated_at":"2026-04-20T00:14:30.312Z","avatar_url":"https://github.com/64bit.png","language":"Rust","funding_links":[],"categories":[],"sub_categories":[],"readme":"# ⌘OK\n\n![Demo of commandOK in action](https://raw.githubusercontent.com/64bit/commandOK/refs/heads/main/commandok.gif)\n\n# commandOK\n\n**commandOK** is a Spotlight-like command generator for your terminal. Pops up when you need it and gets out of the way when you don't.\n\nBuilt with [Ratatui](https://ratatui.rs) and powered by your choice of public, private or local LLM provider.\n\n**WARN**: you must always verify the generated command before accepting it\n\n## Install\n\n```bash\nbrew install 64bit/tap/commandok\n```\n\nOR\n\n```bash\ncargo install commandok\n```\n\n## Setup\n\nOn first run, a default config is created at `~/.commandok/config.toml`. Add your API key for at least one provider:\n\n```toml\n[commandok]\n# Options: anthropic, openai, google, mistral, ollama,\n#          openrouter, xai, vercel_ai_gateway, litert_lm,\n#          apple_intelligence (requires building with --features apple-intelligence on macOS 26+ ARM)\nprovider = \"anthropic\"\nsystem_prompt = \"\"\"\\\nYou are a terminal command generator. Given a natural language description, output ONLY \\\nthe shell command appropriate for the user's OS and shell. No explanation, no markdown, no code blocks, \\\nno backticks. Just the raw command.\\\n\"\"\"\n\n[anthropic]\napi_key = \"\"\nmodel = \"claude-opus-4-6\"\n\n[openai]\napi_key = \"\"\nmodel = \"gpt-5.4\"\n\n[google]\napi_key = \"\"\nmodel = \"gemini-3-flash-preview\"\n\n[mistral]\napi_key = \"\"\nmodel = \"mistral-small-latest\"\n# api_url = \"https://api.mistral.ai/v1\"  # default\n\n[ollama]\nmodel = \"gemma3:1b\"\n# api_url = \"http://localhost:11434\"  # default, change if running elsewhere\n\n[openrouter]\napi_key = \"\"\nmodel = \"qwen/qwen3.6-plus:free\"\n# api_url = \"https://openrouter.ai/api/v1\"  # default\n\n[xai]\napi_key = \"\"\nmodel = \"grok-4.20-0309-reasoning\"\n# api_url = \"https://api.x.ai/v1\"  # default\n\n[vercel_ai_gateway]\napi_key = \"\"\nmodel = \"google/gemini-3-flash\"\n# api_url = \"https://ai-gateway.vercel.sh/v1\"  # default\n\n[litert_lm]\nmodel = \"gemma-4-E2B-it.litertlm\"\nhuggingface_repo = \"litert-community/gemma-4-E2B-it-litert-lm\"\n\n[lmstudio]\nmodel = \"qwen/qwen3-coder-next\"\n# api_url = \"http://localhost:1234\"  # default, change if running elsewhere\n\n[apple_intelligence]\nmodel = \"system\"\n```\n\n## Apple Intelligence (optional)\n\nOn macOS 26+ on Apple Silicon, commandOK can run prompts entirely on-device through Apple's FoundationModels framework. It is gated behind a Cargo feature so the default install does not require the Swift toolchain.\n\n```bash\ncargo install commandok --features apple-intelligence\n```\n\nBuilding the feature requires the Xcode Command Line Tools (`xcode-select --install`). At runtime, Apple Intelligence must be enabled in System Settings.\n\n## Usage\n\nRun `commandok` in any terminal. A search bar appears inline below your cursor.\n\n1. Type a natural language description of the command you need\n2. Press **Enter** -- the command streams in token-by-token\n3. Press **Enter** again to accept (injects the command into your shell) or **Esc** to cancel\n\n### Keybindings\n\n| Key | Action |\n|-----|--------|\n| **Enter** | Submit prompt / Accept generated command |\n| **Esc** | Cancel and dismiss |\n| **Shift+Tab** | Cycle through configured providers |\n| **Up / Down** | Browse prompt history |\n| **Ctrl+U** | Clear input line |\n| **Ctrl+C** | Quit |\n| **Left / Right / Home / End** | Move cursor |\n\n\n## Adding a new provider\n\n1. Create `src/provider/yourprovider.rs` with a `pub async fn stream(...)` function\n2. Add `pub mod yourprovider;` to `src/provider/mod.rs`\n3. Add a variant to the `Provider` enum and wire it in `from_name()` / `stream()`\n4. Add the section to `Config` in `src/config.rs` and `PROVIDER_ORDER`\n\n## License\n\nMIT\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2F64bit%2Fcommandok","html_url":"https://awesome.ecosyste.ms/projects/github.com%2F64bit%2Fcommandok","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2F64bit%2Fcommandok/lists"}