{"_id":"@abdullahadeeb/tars","name":"@abdullahadeeb/tars","dist-tags":{"latest":"1.0.0"},"versions":{"1.0.0":{"name":"@abdullahadeeb/tars","version":"1.0.0","description":"An AI-powered CLI assistant using Google's Gemini API","main":"index.js","type":"module","bin":{"tars":"index.js"},"scripts":{"test":"echo \"Error: no test specified\" && exit 1"},"dependencies":{"openai":"^4.28.0"},"keywords":["cli","ai","google-api","chat","gemini","terminal","ai-assistant","command-line"],"author":{"name":"Abdullah Adeeb"},"license":"MIT","repository":{"type":"git","url":"git+https://github.com/AbdullahAdeebx/tars.git"},"bugs":{"url":"https://github.com/AbdullahAdeebx/tars/issues"},"homepage":"https://github.com/AbdullahAdeebx/tars#readme","engines":{"node":">=14.0.0"},"_id":"@abdullahadeeb/tars@1.0.0","gitHead":"9e53e1013ea8000f1511c08e53ecafc7180a5dfa","_nodeVersion":"22.14.0","_npmVersion":"11.1.0","dist":{"integrity":"sha512-LQJgO9nBXyPWL4EimcyqsHCIY8kGBtItvwo+r1jPjyq33sTTRKckileBmPmzun59pnNhj/YbVfRqf+xSgAfCxA==","shasum":"4c1800be7e0714552f0d26be25e26bd16d79549f","tarball":"https://registry.npmjs.org/@abdullahadeeb/tars/-/tars-1.0.0.tgz","fileCount":4,"unpackedSize":9389,"signatures":[{"keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U","sig":"MEUCIQCSGMIfTnjOFYqx8youRa8yOblLLOs1/gHqt2Sh8TOeCAIgDxZ3Wd1F6kzkJHQWsktUnVyFbOfwBFWEAO1SpW44EY0="}]},"_npmUser":{"name":"abdullahadeeb","email":"abdullah@abdullahadeeb.xyz"},"directories":{},"maintainers":[{"name":"abdullahadeeb","email":"abdullah@abdullahadeeb.xyz"}],"_npmOperationalInternal":{"host":"s3://npm-registry-packages-npm-production","tmp":"tmp/tars_1.0.0_1742220787284_0.005723017867266478"},"_hasShrinkwrap":false}},"time":{"created":"2025-03-17T14:13:07.180Z","1.0.0":"2025-03-17T14:13:07.520Z","modified":"2025-03-17T14:13:07.763Z"},"maintainers":[{"name":"abdullahadeeb","email":"abdullah@abdullahadeeb.xyz"}],"description":"An AI-powered CLI assistant using Google's Gemini API","homepage":"https://github.com/AbdullahAdeebx/tars#readme","keywords":["cli","ai","google-api","chat","gemini","terminal","ai-assistant","command-line"],"repository":{"type":"git","url":"git+https://github.com/AbdullahAdeebx/tars.git"},"author":{"name":"Abdullah Adeeb"},"bugs":{"url":"https://github.com/AbdullahAdeebx/tars/issues"},"license":"MIT","readme":"# Tars - Your Terminal AI Companion\r\n\r\n[![Created by Abdullah Adeeb](https://img.shields.io/badge/Created%20by-Abdullah%20Adeeb-blue)](https://www.abdullahadeeb.xyz)\r\n\r\n\r\nTars is a command-line interface (CLI) application that lets you chat with Google's Gemini AI directly from your terminal. It uses Google's Gemini API via an OpenAI-compatible interface.\r\n\r\n## Features\r\n\r\n- **Interactive Chat Mode**: Have a back-and-forth conversation with the AI\r\n- **Single Query Mode**: Get quick answers without entering a chat session\r\n- **Secure API Key Storage**: Your Google API key is stored securely in your home directory\r\n\r\n## Installation\r\n\r\n```bash\r\n# Install globally from npm\r\nnpm install -g @abdullahadeeb/tars\r\n```\r\n\r\n## Usage\r\n\r\n### Interactive Chat Mode\r\n\r\nStart an interactive chat session with the AI:\r\n\r\n```bash\r\ntars\r\n```\r\n\r\nThis will start a conversation where you can type messages and receive responses from the AI. Type `exit`, `quit`, or `bye` to end the session.\r\n\r\n### Single Query Mode\r\n\r\nGet a quick answer without starting a chat session:\r\n\r\n```bash\r\ntars \"What is the capital of France?\"\r\n```\r\n\r\n## First-Time Setup\r\n\r\nOn your first run, Tars will prompt you to enter your Google API key. This key will be saved in your home directory (`~/.tars_api_key`) for future use.\r\n\r\nTo get a Google API key:\r\n1. Go to the [Google AI Studio](https://aistudio.google.com/)\r\n2. Create an account or sign in\r\n3. Navigate to the API section and create a new API key\r\n\r\n## Troubleshooting\r\n\r\n### API Key Issues\r\n\r\nIf you need to update your API key, you can delete the existing key file and run Tars again:\r\n\r\n- On Windows: Delete `%USERPROFILE%\\.tars_api_key`\r\n- On macOS/Linux: Delete `~/.tars_api_key`\r\n\r\n\r\n## For Developers\r\n\r\n### Local Development Setup\r\n\r\n1. Clone the repository:\r\n   ```bash\r\n   git clone https://github.com/AbdullahAdeebx/tars\r\n   cd tars\r\n   ```\r\n\r\n2. Install dependencies:\r\n   ```bash\r\n   npm install\r\n   ```\r\n\r\n3. Link the package locally to test it:\r\n   ```bash\r\n   npm link\r\n   ```\r\n\r\n4. Now you can run the CLI tool:\r\n   ```bash\r\n   tars\r\n   ```\r\n\r\n## Requirements\r\n\r\n- Node.js 14.0 or higher\r\n\r\n## License\r\n\r\nMIT ","readmeFilename":"README.md","_rev":"1-0bc6a06b0334e96cd3897d53c91ce77c"}