# macta > A virtual assistant for providing MacOS terminal command prompts. Latest version **1.1.17** (published 2024-03-15) · ISC license · 0 weekly downloads ## Install ```sh npm install macta pnpm add macta yarn add macta bun add macta ``` Provides the command `macta`. ## Health **Score 15/100 (F)** — status: abandoned. Positive: no vulnerabilities. Warnings: low downloads; no types; no esm support. Negative: abandoned; low maintenance score. ## Facts | | | |---|---| | Version | 1.1.17 | | Published | 2024-03-15 | | First published | 2023-02-10 | | Weekly downloads | 0 | | License | ISC | | TypeScript types | none | | Module format | CommonJS | | Dependencies | 5 | | Unpacked size | 286.8 KB | | Known vulnerabilities | 0 (+1 in 1 direct dependencies) | | Install scripts | no | | Author | Your Name | | Maintainers | damon_the_dev | ## Links - npm: https://www.npmjs.com/package/macta - Repository: https://github.com/damonpickett/macta - Homepage: https://github.com/damonpickett/macta#readme - Issues: https://github.com/damonpickett/macta/issues - npm.io page: https://npm.io/package/macta ## Dependencies (5) - [fs](https://npm.io/package/fs.md) 0.0.1-security - [path](https://npm.io/package/path.md) ^0.12.7 - [axios](https://npm.io/package/axios.md) ^1.6.7 - [openai](https://npm.io/package/openai.md) ^4.29.0 - [readline](https://npm.io/package/readline.md) ^1.3.0 ## Recent versions - 1.1.17 (latest) — 2024-03-15 - 1.1.16 — 2024-03-15 - 1.0.16 — 2023-02-26 - 1.0.15 — 2023-02-16 - 1.0.14 — 2023-02-16 - 1.0.13 — 2023-02-15 - 1.0.12 — 2023-02-15 - 1.0.11 — 2023-02-14 - 1.0.10 — 2023-02-14 - 1.0.9 — 2023-02-14 - 1.0.8 — 2023-02-10 - 1.0.7 — 2023-02-10 - 1.0.6 — 2023-02-10 - 1.0.5 — 2023-02-10 - 1.0.4 — 2023-02-10 - … 4 more at https://npm.io/package/macta/versions ## README # MacTA *Macintosh Terminal Assistant* ## Table of Contents - [Project Title](#macta) - [Description](#description) - [Tech Stack](#tech-stack) - [Installation](#installation) - [Usage](#usage) - [Contributing](#contributing) - [License](#license) ## Description MacTA is command-line application that utilizes the OpenAI API to generate instructions for performing tasks in the MacOS terminal. The purpose of this application is to generate clear and concise instructions without having to leave the terminal. This can be particularly helpful for individuals who are new to the terminal or unfamiliar with specific terminal commands. After installation, upon the user's first attempt run MacTA, MacTA will prompt the user for their OpenAI API key. This will stored in a `config.json` file which will be saved in the MacTA directory within your global directory. The user will only have to enter their API key once. ![MacTA Demo](./assets/macta_demo.gif) This program is free to use. However, if you would like to buy me a coffee, you can do so here:

Buy me a cofee button

## Tech Stack This project utilizes several technologies, including: * [**OpenAI API**](https://openai.com/api/): A cloud-based platform that allows users to build various artificial intelligence models, including natural language processing models that can generate text. * [**readline**](https://nodejs.org/api/readline.html): A Node.js module that provides an interface for reading input from a user via the command line. * [**fs**](https://nodejs.org/api/fs.html): A Node.js module that provides an interface for working with the file system. * [**path**](https://nodejs.org/api/path.html): A Node.js module that provides utilities for working with file and directory paths. In this project, the OpenAI API is used to generate text in response to user input. The readline module is used to read user input from the command line, while the fs module is used to read and write configuration data to a file. The path module is used to construct file paths for the configuration file. ## Installation 1. Install Node.js on your system. You can download Node.js from the official website: [Node.js](https://nodejs.org/) 2. Install MacTA globally by running the following command in your terminal: `npm install -g macta` 3. Obtain an API key for the OpenAI API from the [OpenAI website](https://beta.openai.com/signup/) 4. Run MacTA by entering the following command in your terminal: `macta` You should now be prompted to enter a task description. MacTA will generate instructions based on your input. ## Usage 1. Open your terminal and type `macta` from within any directory in your terminal. 2. You will be prompted to enter a description of the task you'd like to perform. For best results, simply answer the question “How do I…?” E.G. `delete a file`. 3. MacTA will generate a set of instructions based on your task description. The instructions will include a command-line example for the task, as well as any additional details that might be helpful. 4. If you'd like to perform another task, simply run the `macta` command again and repeat the process. To see MacTA in action, check out this brief [video tutorial](https://youtu.be/SpQPNKdlkGY). ## Contributing If you encounter a bug while using macta or would like to request a new feature, please submit an issue on the macta GitHub repository. To submit an issue, follow these steps: 1. Click the "Issues" tab at the top of the page. 2. Click the "New issue" button. 3. Fill out the template with as much detail as possible, including steps to reproduce the bug or a clear description of the new feature you're requesting. 4. Click the "Submit new issue" button. Once you've submitted an issue, I will review it and respond ASAP. ## License ISC --- _Source: https://npm.io/package/macta · Machine-readable twin of the npm.io package page. Health data is recomputed on every publish._