{"id":29103309,"url":"https://github.com/callstack/ai-cli","last_synced_at":"2026-03-05T02:04:16.708Z","repository":{"id":220882690,"uuid":"748877542","full_name":"callstack/ai-cli","owner":"callstack","description":"AI assistant in your terminal.","archived":false,"fork":false,"pushed_at":"2025-01-23T14:05:14.000Z","size":6208,"stargazers_count":45,"open_issues_count":6,"forks_count":2,"subscribers_count":4,"default_branch":"main","last_synced_at":"2025-10-24T03:44:07.327Z","etag":null,"topics":["ai","assistant","cli","llm","terminal"],"latest_commit_sha":null,"homepage":"https://callstack.github.io/ai-cli/","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/callstack.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":"CONTRIBUTING.md","funding":null,"license":"LICENSE","code_of_conduct":"CODE_OF_CONDUCT.md","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":"2024-01-26T23:44:39.000Z","updated_at":"2025-10-17T09:47:44.000Z","dependencies_parsed_at":"2024-08-17T21:54:06.961Z","dependency_job_id":null,"html_url":"https://github.com/callstack/ai-cli","commit_stats":null,"previous_names":["callstack/ai-cli"],"tags_count":23,"template":false,"template_full_name":null,"purl":"pkg:github/callstack/ai-cli","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/callstack%2Fai-cli","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/callstack%2Fai-cli/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/callstack%2Fai-cli/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/callstack%2Fai-cli/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/callstack","download_url":"https://codeload.github.com/callstack/ai-cli/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/callstack%2Fai-cli/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":30106168,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-03-05T01:39:18.192Z","status":"online","status_checked_at":"2026-03-05T02:00:06.710Z","response_time":93,"last_error":null,"robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":true,"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":["ai","assistant","cli","llm","terminal"],"created_at":"2025-06-28T23:41:50.607Z","updated_at":"2026-03-05T02:04:16.701Z","avatar_url":"https://github.com/callstack.png","language":"TypeScript","readme":"# AI CLI\n\nAI assistant in your terminal.\n\n```shell-session\n$ ai \"Tell me an interesting fact about the Roman Empire\"\nme: Tell me an interesting fact about the Roman Empire\nai: The Roman Empire had a vast network of roads extending over 250,000 miles at its peak...\n```\n\n## Installation\n\nInstall `@callstack/ai-cli` npm package globally:\n\n```sh\nnpm install -g @callstack/ai-cli\n```\n\n## Setup\n\n### API key\n\nYou will need a valid API key from one of supported AI inference providers: OpenAI or Perplexity. Using these APIs is paid but the costs should be very low, typically much less than $0.01 per interaction.\n\n### Quick config\n\nRun `ai init` to create a basic `~/.airc.json` config file with your OpenAI or Perplexity API key.\n\n```shell-session\n$ ai init\n```\n\nRead more about the [configuration file](https://callstack.github.io/ai-cli/config-file) format and available option.\n\n## Usage\n\nRun `ai [query]` to start a chat with an AI assistant. You can put the question in the params.\n\n```shell-session\n$ ai \"Tell me a joke\"\nme: Tell me a joke\nai: Why don’t skeletons fight each other? They don’t have the guts.\n```\n\n## CLI options\n\nCLI options are passed when invoking the `ai` commend:\n\n- `--help`: display available options\n- `--provider [name]` (or `-p [name]`): select an inference provider to use\n- `--model [name]` (or `-m [name]`): select a model to use\n- `--creative`: respond in a creative way\n- `--precise`: respond in a more accurate way\n\nYou need to have an API key for selected provider in your `~/.airc.json` file.\n\nSee more info about the [command line options](https://callstack.github.io/ai-cli/#cli-options).\n\n## CLI commands\n\nCLI commands are available when using CLI in interactive mode.\n\n- `/help`: display available commands\n- `/exit`: exit the CLI\n- `/info`: display information about current session\n- `/forget`: forget previous messages in the session\n- `/verbose`: enable/disable verbose mode\n\n## Contributing\n\nSee the [contributing guide](CONTRIBUTING.md) to learn how to contribute to the repository and the development workflow.\n\n## License\n\nMIT\n","funding_links":[],"categories":[],"sub_categories":[],"project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fcallstack%2Fai-cli","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fcallstack%2Fai-cli","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fcallstack%2Fai-cli/lists"}