{"id":25019340,"url":"https://github.com/gusruben/magics","last_synced_at":"2025-07-17T02:41:44.074Z","repository":{"id":274574627,"uuid":"918067774","full_name":"gusruben/magics","owner":"gusruben","description":null,"archived":false,"fork":false,"pushed_at":"2025-02-03T04:58:52.000Z","size":82912,"stargazers_count":0,"open_issues_count":0,"forks_count":0,"subscribers_count":1,"default_branch":"main","last_synced_at":"2025-02-05T11:40:16.379Z","etag":null,"topics":[],"latest_commit_sha":null,"homepage":null,"language":"JavaScript","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":null,"status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/gusruben.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":null,"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":"2025-01-17T07:28:33.000Z","updated_at":"2025-02-03T04:58:56.000Z","dependencies_parsed_at":"2025-01-28T06:21:46.008Z","dependency_job_id":"eb8b7bdd-0c10-401f-aa2d-1523ea5c6e88","html_url":"https://github.com/gusruben/magics","commit_stats":null,"previous_names":["gusruben/magics"],"tags_count":0,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/gusruben%2Fmagics","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/gusruben%2Fmagics/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/gusruben%2Fmagics/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/gusruben%2Fmagics/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/gusruben","download_url":"https://codeload.github.com/gusruben/magics/tar.gz/refs/heads/main","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":246301965,"owners_count":20755512,"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":"2025-02-05T11:40:08.524Z","updated_at":"2025-03-30T09:41:15.913Z","avatar_url":"https://github.com/gusruben.png","language":"JavaScript","funding_links":[],"categories":[],"sub_categories":[],"readme":"# Magics ✨\n\nMagics is an AI-powered extension of `ls`-- at a glance you can get an idea of the more complex purpose of files and directories. It's powered by OpenAI ChatGPT in the backend, and it gets context on relevant files and directories to make smart summaries of what you're looking at. \n\n## Installation 🚀\n\nMagics is available [available on the Node Package Registry](https://www.npmjs.com/package/magics-ls)! Install it with:\n```\nnpm install -g magics-ls\n```\n\n## Usage 🔧\n\nTo use Magics, set your OpenAI API key as such:\n```\nexport OPENAI_API_KEY=sk-proj-...\n```\n\nThen, just run `ms` to list the contents of the current directory along with helpful summaries.\n\n### Example 🗒️\n\n```sh\n$ ms\ntotal 44\n-rwxrwxrwx  1 gusruben users 23926 Jan 27 23:21 bun.lockb     - Lockfile format for dependency management, likely related to package versions and metadata.\n-rw-r--r--  1 gusruben users  2468 Jan 27 23:56 index.ts      - TypeScript file defining API interactions, filesystem and command execution using ChatGPT service.\ndrwxr-xr-x 62 gusruben users  4096 Jan 27 23:21 node_modules  - A list of dependencies for the NodeJS project.\n-rw-r--r--  1 gusruben users   226 Jan 27 23:21 package.json  - Configuration file for Node.js projects, specifying metadata, dependencies, and scripts.\n-rw-r--r--  1 gusruben users   140 Jan 17 02:26 README.md     - Documentation file providing information, instructions, guidelines, and context for a project or repository.\n-rw-r--r--  1 gusruben users   635 Jan 17 02:22 tsconfig.json - TypeScript configuration file specifying compilation options, target version, and other compiler settings.\n```\n\n### Demo 📺\n\n![Magics demo](https://raw.githubusercontent.com/gusruben/magics/refs/heads/main/magics.gif)\n\n\u003e GIF not displaying properly? Try viewing the file [here](https://github.com/gusruben/magics/blob/main/magics.gif). ","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fgusruben%2Fmagics","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fgusruben%2Fmagics","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fgusruben%2Fmagics/lists"}