{"id":31914734,"url":"https://github.com/ariana-dot-dev/user-guide","last_synced_at":"2026-02-18T13:01:26.447Z","repository":{"id":308187050,"uuid":"1031891879","full_name":"ariana-dot-dev/user-guide","owner":"ariana-dot-dev","description":"user guide for the earliest version of Ariana IDE","archived":false,"fork":false,"pushed_at":"2025-08-06T16:26:37.000Z","size":40300,"stargazers_count":0,"open_issues_count":0,"forks_count":0,"subscribers_count":0,"default_branch":"main","last_synced_at":"2025-10-22T04:51:59.609Z","etag":null,"topics":[],"latest_commit_sha":null,"homepage":null,"language":null,"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/ariana-dot-dev.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,"zenodo":null}},"created_at":"2025-08-04T13:41:24.000Z","updated_at":"2025-08-04T15:23:38.000Z","dependencies_parsed_at":"2025-08-04T19:23:55.806Z","dependency_job_id":null,"html_url":"https://github.com/ariana-dot-dev/user-guide","commit_stats":null,"previous_names":["ariana-dot-dev/user-guide"],"tags_count":0,"template":false,"template_full_name":null,"purl":"pkg:github/ariana-dot-dev/user-guide","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/ariana-dot-dev%2Fuser-guide","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/ariana-dot-dev%2Fuser-guide/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/ariana-dot-dev%2Fuser-guide/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/ariana-dot-dev%2Fuser-guide/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/ariana-dot-dev","download_url":"https://codeload.github.com/ariana-dot-dev/user-guide/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/ariana-dot-dev%2Fuser-guide/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":29580633,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-02-18T08:38:15.585Z","status":"ssl_error","status_checked_at":"2026-02-18T08:38:14.917Z","response_time":162,"last_error":"SSL_read: unexpected eof while reading","robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":false,"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":[],"created_at":"2025-10-13T19:27:30.222Z","updated_at":"2026-02-18T13:01:26.431Z","avatar_url":"https://github.com/ariana-dot-dev.png","language":null,"funding_links":[],"categories":[],"sub_categories":[],"readme":"# Ariana IDE\n\n\u003cdiv align=\"center\"\u003e\n  \u003cimg src=\"app-icon.png\" alt=\"Ariana IDE Logo\" width=\"128\" height=\"128\"\u003e\n  \u003ch2\u003eUser Guide Early Adopter Version\u003c/h2\u003e\n\u003c/div\u003e\n\nPeople responsible for this banger and who you can contact in case of problems or bugs:\n\nAnicet - @anicetngrt | telegram\n\nKirill - @luaroncrew | telegram\n\n## Table of Contents\n\n1. [Using Agents](#using-agents)\n2. [Installation](#installation)\n3. [Authentication \u0026 Claude Configuration](#authentication--claude-configuration)\n4. [Updating the App](#updating-the-app)\n\n---\n\n## Using Agents 🤖\n\nTo start using agents, please choose a project, open it, then click + to create a new agent\n\n\u003cdiv align=\"center\"\u003e\n  \u003cimg src=\"agents.gif\" alt=\"Ariana IDE Logo\"\u003e\n\u003c/div\u003e\n\nOnce the agent is initialized, you can ask it questions, give orders, and use it like you would usually use Claude Code\n\nWhen an agent decides to add something to your codebase, you will be able to see these changes as incoming commits on the agent's personal branch inside your repository:\n\n\u003cdiv align=\"center\"\u003e\n  \u003cimg src=\"branches.gif\" alt=\"Ariana IDE Logo\"\u003e\n\u003c/div\u003e\n\n*Enjoy Vibecoding! ✨*\n\n## Installation 📦\n\nIn the early adopter Telegram group, you will find the app distribution files for macOS, Windows, and Linux.\n\n#### macOS Specific\n\nWhen you try to run the app, you may have this error appear:\n\u003cdiv align=\"center\"\u003e\n  \u003cimg src=\"mac-installation-error.png\" alt=\"Ariana IDE Logo\"\u003e\n\u003c/div\u003e\n\nDon't worry, just run 🔧 \n\n```sh\nsudo xattr -rd com.apple.quarantine \"/Applications/ariana IDE.app\"\n\n# you will be prompted for your device password\n```\n\n\nThis will remove Apple's security restriction on the app from the unknown (soon very popular) distributor\n\n---\n\n## Authentication \u0026 Claude Configuration 🔐\n\n### Setting Up Claude API\n\n#### Windows\n\nOn Windows, there's a file `~/.claude/.credentials.json` which contains the necessary data for us to run your Claude subscription on cloud machines. The token there is refreshed automatically whenever you use Claude from your device. Ariana is capable of accessing this data. So, great news - you have nothing to do. 🎉\n\n#### MacOS\n\nmacOS includes more security features, so the credentials file does not exist. Instead, on macOS you have a keychain store, which holds your credentials in an encrypted way. Ariana has not learned how to get them automatically, so you will have to go through manual Claude credentials setup\n\n\n#### Manual Setup\nFor macOS users, you need to navigate to the Keychain Access application and search for \"claude\". In there you will find a field, normally accessible to read after password input. When done, copy the object you find there and paste it into the Ariana application\n\n\u003cdiv align=\"center\"\u003e\n  \u003cimg src=\"keychain.gif\" alt=\"Ariana IDE Logo\"\u003e\n\u003c/div\u003e\n\n\n#### ⚠️ Warning!\n\nThe macOS OAuth tokens have a very short lifespan and are not refreshed by Ariana. If you encounter a 401 error when using the agent, please repeat the manual setup.\n\n#### Awareness 🔒\nWe do not store your Claude credentials in any database. The only purpose of having them is to allow you to use your Claude subscription on our VMs, and unfortunately, this is the most secure existing way to do this as of August 2025. Your credentials are stored only on your machine and then transferred to the VM directly by Ariana acting as a proxy.\n\n\n### Authentication 🔑\n\nGitHub authentication flow. Be sure to give access to repositories you want to use. The \"GitHub Permissions\" tab in the user menu allows you to change the permissions you grant to Ariana. \n\n\n---\n\n\n## Updating the App 🔄\n\nThe app supports automatic updates. Just go to the updates tab and check whether there's an update available. If there is one, just click on the update button and you will get the latest version with no friction.\n\n\u003cdiv align=\"center\"\u003e\n  \u003cimg src=\"updates.gif\" alt=\"Ariana IDE Logo\"\u003e\n\u003c/div\u003e\n\n\n---\n\n*Welcome to the future of AI-powered development. Happy coding! 🚀*\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fariana-dot-dev%2Fuser-guide","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fariana-dot-dev%2Fuser-guide","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fariana-dot-dev%2Fuser-guide/lists"}