{"id":23468390,"url":"https://github.com/dikkadev/ai-shell","last_synced_at":"2025-04-12T21:39:23.727Z","repository":{"id":184434762,"uuid":"668868728","full_name":"dikkadev/ai-shell","owner":"dikkadev","description":"A command-line tool that uses GPT-3.5-turbo to generate precise console commands based on your instructions + generated contexts","archived":false,"fork":false,"pushed_at":"2024-10-19T09:30:44.000Z","size":54,"stargazers_count":0,"open_issues_count":0,"forks_count":0,"subscribers_count":1,"default_branch":"main","last_synced_at":"2025-04-05T23:55:49.051Z","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":"gpl-3.0","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/dikkadev.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}},"created_at":"2023-07-20T19:30:57.000Z","updated_at":"2024-10-19T09:30:47.000Z","dependencies_parsed_at":"2024-05-17T08:27:23.934Z","dependency_job_id":"1bd4682e-86ae-40e6-9ef3-b450a94e4f17","html_url":"https://github.com/dikkadev/ai-shell","commit_stats":null,"previous_names":["sett17/ai-shell","dikkadev/ai-shell"],"tags_count":1,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/dikkadev%2Fai-shell","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/dikkadev%2Fai-shell/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/dikkadev%2Fai-shell/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/dikkadev%2Fai-shell/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/dikkadev","download_url":"https://codeload.github.com/dikkadev/ai-shell/tar.gz/refs/heads/main","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":248631679,"owners_count":21136562,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","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":"2024-12-24T13:52:55.484Z","updated_at":"2025-04-12T21:39:23.695Z","avatar_url":"https://github.com/dikkadev.png","language":"Go","funding_links":[],"categories":[],"sub_categories":[],"readme":"# for ai-shell\n\nWelcome to ai-shell! It's a command-line tool that uses OpenAI's GPT-3.5-turbo to generate precise console commands based on your instructions. It takes in your commands, gathers some context, and lets an AI model figure out the best course of action.\n\n## What You'll Need\n\n1. An OpenAI API key: This is non-negotiable. You'll need this to connect to OpenAI's API and make magic happen. Make sure to set it as an environment variable `OPENAI_API_KEY`.\n\n## Getting ai-shell on Your Machine\n\n### Option 1: Use Go\n\nIf you have Go set up on your machine, it's a breeze. Just use the following command:\n\n\n```bash\ngo install github.com/sett17/ai-shell@latest\n```\n\n### Option 2: Grab the Binary\n\nI've also got pre-compiled binaries for you. Just head over to the [Releases](https://github.com/sett17/ai-shell/releases) page, download the version you need, and you're good to go.\n\n### Use `ai` instead of `ai-shell`\n\nIf you are in a unix system you can easily create an `ai` symlink for `ai-shell`.\n\n```bash\nln -s ~/go/bin/ai-shell ~/go/bin/ai\n```\n\n*Or whatever your `GOPATH` is when looking up `go env` :)*\n\n## Configuration\n\nai-shell uses a configuration file (`config.toml`) to customize its behavior. By default, this file is located in the local configuration directory for your system:\n\n- On Linux and Unix systems: `~/.config/ai-shell/config.toml`\n- On Windows: `%APPDATA%/ai-shell/config.toml` or `C:\\Users\\%USER%\\AppData\\Roaming\\ai-shell\\config.toml`\n\nDon't worry if you don't find the config file there, ai-shell will create one with default values for you on its first run.\n\n### Configuration Structure\n\nEach context item has two common settings:\n\n- `Enabled`: A Boolean that controls whether this context is enabled.\n- `Priority`: An integer that determines the order in which this context is considered by the AI. Higher numbers mean higher priority.\n\nMoreover, some contexts may have additional configuration settings.\n\n### Context-Specific Configurations\n\n| Context | Description | Additional Settings |\n| --- | --- | --- |\n| FileListing | Provides file listing context to the AI. | / |\n| Shell | Provides shell context to the AI. | / |\n\nThis structure will be maintained as more context types are added in the future. Each new context will come with its own `Enabled` and `Priority` settings and may include additional context-specific configurations.\n\n## How to Use ai-shell\n\nIt's quite simple to use ai-shell. You input an instruction, and the AI spits out a command. You can revise this command, and then either execute it or exit. That's all there is to it.\n\nA neat feature is that you can tweak how the AI understands your instructions using context. You can enable or disable different contexts and prioritize them in accordance with your needs.\n\n## Contributing\n\nFeel free to contribute to ai-shell. I don't have a formal contribution guide yet, but just submit a PR, and I'll take a look.\n\n## License\n\nFor details on the license, please check the [LICENSE](https://github.com/sett17/ai-shell/blob/main/LICENSE) file.\n\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fdikkadev%2Fai-shell","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fdikkadev%2Fai-shell","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fdikkadev%2Fai-shell/lists"}