Skip to content
Back to search

agasthy

MarketplaceWorks with Claude CodeGitHub

AGASTHY for coding agents: a read-only skill and MCP server with real answers about your developer machine.

Safety scan

A static text scan, not a guarantee. Select the badge to see what was scanned and every finding.

Checked today

Check it deeper on your machine

It has changed since its scan on 17 Nov 2026.

As a Claude Code plugin, install it and then ask Claude Code:

/plugin marketplace add keithmackay/mackayi/plugin install scanskillsafety@mackayiDo a deep scan of https://github.com/HMAKT99/Agasthy with scanskillsafety

Or from a terminal, clone it and run it:

git clone https://github.com/keithmackay/scanskillsafety-skill ~/.claude/skills/scanskillsafetynode ~/.claude/skills/scanskillsafety/cli.cjs --deep 'https://github.com/HMAKT99/Agasthy'

It checks the exact commit: every file, its packages against OSV (api.osv.dev), how it compares with this page's scan (findsafeskills.com receives the repository's address), and, if you agree, Claude reading every file with your own Claude subscription. It never runs the code.

Badge for your README
findsafeskills safety rating

Markdown

[![findsafeskills safety rating](/api/listings/hmakt99--agasthy/badge.svg)](/listings/hmakt99--agasthy)

HTML

<a href="/listings/hmakt99--agasthy"><img src="/api/listings/hmakt99--agasthy/badge.svg" alt="findsafeskills safety rating" /></a>

Install

Install instructions from the README

As written by the repo's author. findsafeskills has not verified these steps.

> [!IMPORTANT] > **Expect one security prompt on first launch.** AGASTHY is not yet signed with a paid Apple Developer ID or a Windows code-signing certificate. That does not mean anything is wrong with the download; it means the operating system cannot check who published it. > > - **macOS:** "Apple could not verify AGASTHY is free of malware" → **System Settings → Privacy & Security → Open Anyway**. > - **Windows:** "Windows protected your PC" (SmartScreen) → **More info → Run anyway**. > - **Linux:** no prompt; just make the AppImage executable. > > You only do this once; updates install without it. To check a download yourself, compare it with the `.sha256` file next to it on the release page (`shasum -a 256 <file>` on macOS, `Get-FileHash <file>` on Windows, `sha256sum <file>` on Linux).

**macOS (Apple silicon, macOS 12+)**

**[⬇ Download AGASTHY for macOS (Apple silicon)](https://github.com/HMAKT99/Agasthy/releases/download/v0.1.6/AGASTHY-0.1.6-apple-silicon.dmg)**

Open it and drag **AGASTHY** to **Applications**. The first time, macOS says it cannot verify the developer (the app is not notarized yet): **System Settings → Privacy & Security → Open Anyway**. Then scan your code folder.

Or with [Homebrew](https://brew.sh):

brew install --cask hmakt99/tap/agasthy     # the app
brew install hmakt99/tap/agasthy-cli        # optional: the read-only CLI and MCP server for agents

Using a coding agent without Homebrew? Get [⬇ the CLI](https://github.com/HMAKT99/Agasthy/releases/latest/download/agasthy-cli-macos-aarch64.tar.gz) (unpack it and put `agasthy` on your PATH) or [⬇ the Claude Desktop extension](https://github.com/HMAKT99/Agasthy/releases/download/v0.1.6/agasthy-mcp-0.1.6.mcpb) (double-click it).

**Windows (x64, preview)**

**[⬇ Download AGASTHY for Windows (x64)](https://github.com/HMAKT99/Agasthy/releases/download/v0.1.6/AGASTHY_0.1.6_x64-setup.exe)**

Run it. Windows says "Windows protected your PC" because the installer is not code-signed yet: **More info → Run anyway**. Then scan your code folder.

Using a coding agent? Also get [⬇ the CLI](https://github.com/HMAKT99/Agasthy/releases/latest/download/agasthy-cli-windows-x86_64.zip) (Claude Code, Cursor, Codex; unzip it and put `agasthy.exe` on your PATH) or [⬇ the Claude Desktop extension](https://github.com/HMAKT99/Agasthy/releases/download/v0.1.6/agasthy-mcp-0.1.6.mcpb) (double-click it).

**Linux (x64, preview)**

**[⬇ Download AppImage (any distribution)](https://github.com/HMAKT99/Agasthy/releases/download/v0.1.6/AGASTHY_0.1.6_amd64.AppImage)** · **[⬇ Download .deb (Ubuntu, Debian)](https://github.com/HMAKT99/Agasthy/releases/download/v0.1.6/agasthy_0.1.6_amd64.deb)**

AppImage: `chmod +x AGASTHY_*_amd64.AppImage` and run it. .deb: `sudo apt install ./agasthy_*_amd64.deb`. Then scan your code folder. Built and launch-tested in CI on Ubuntu; feedback from other distributions welcome.

Using a coding agent? Also get [⬇ the CLI](https://github.com/HMAKT99/Agasthy/releases/latest/download/agasthy-cli-linux-x86_64.tar.gz) (unpack it and put `agasthy` on your PATH) or [⬇ the Claude Desktop extension](https://github.com/HMAKT99/Agasthy/releases/download/v0.1.6/agasthy-mcp-0.1.6.mcpb).

AGASTHY lives in the menu bar: closing the window keeps it running, and **Quit** is in the menu-bar menu. Updates are offered in the app, signature-checked, and installed only when you click **Install and restart**.

What was scanned

The files the safety scan read, as written by the repository's author and shown as plain text. Lines with a finding are marked.

.claude-plugin/marketplace.json · Manifest · 18 lines
  1. {
  2. "$schema": "https://anthropic.com/claude-code/marketplace.schema.json",
  3. "name": "agasthy",
  4. "description": "AGASTHY for coding agents: a read-only skill and MCP server with real answers about your developer machine.",
  5. "owner": {
  6. "name": "HMAKT99",
  7. "url": "https://github.com/HMAKT99"
  8. },
  9. "plugins": [
  10. {
  11. "name": "agasthy",
  12. "description": "Ask your machine with real data: repositories and uncommitted work, runtimes and packages, what breaks if you remove something, live coding-agent sessions and what they left running, processes and ports, and token usage. Read-only skill plus MCP server for AGASTHY.",
  13. "category": "productivity",
  14. "source": "./plugins/agasthy",
  15. "homepage": "https://github.com/HMAKT99/Agasthy"
  16. }
  17. ]
  18. }
README.md · README · 251 lines
  1. <p align="center">
  2. <img src="apps/desktop/app-icon.svg" width="88" alt="AGASTHY mark" />
  3. </p>
  4. <h1 align="center">AGASTHY</h1>
  5. <p align="center"><strong>One intelligence layer for your developer machine.</strong></p>
  6. <p align="center">
  7. Every repo, runtime, package and AI tool on your machine, connected in a live knowledge graph.<br/>
  8. Track coding agents and what they cost, see what breaks before you remove anything,<br/>
  9. free disk space safely, and ask plain questions about your machine with evidence behind every answer.
  10. </p>
  11. <p align="center">
  12. <a href="https://github.com/HMAKT99/Agasthy/releases/download/v0.1.6/AGASTHY-0.1.6-apple-silicon.dmg"><strong>⬇ Download for Mac (Apple silicon)</strong></a> ·
  13. <a href="https://github.com/HMAKT99/Agasthy/releases/download/v0.1.6/AGASTHY_0.1.6_x64-setup.exe">⬇ Windows preview</a> ·
  14. <a href="https://github.com/HMAKT99/Agasthy/releases/download/v0.1.6/AGASTHY_0.1.6_amd64.AppImage">⬇ Linux preview</a> ·
  15. free and open source · no account · no telemetry
  16. </p>
  17. https://github.com/user-attachments/assets/2718c8ae-1576-4c4f-a494-646731a019fa
  18. ---
  19. ## Why you'll want it
  20. A developer machine holds hundreds of moving parts: cloned repositories, several copies of the same runtime, packages from six package managers, AI tools with their own configs, and now coding agents starting servers in every terminal. Nothing shows you how they connect, what they cost, or what is safe to remove. **AGASTHY reads the machine itself, links everything in one graph, and lets you act on it safely.**
  21. | | |
  22. |---|---|
  23. | 📦 **Everything, discovered** | Repositories (branch, uncommitted work, remotes, duplicate clones), applications, CLI tools and runtimes (which copy is active, which are shadowed), and packages from Homebrew, npm, pnpm, uv, pip and cargo. Every fact carries its evidence. |
  24. | 🕸️ **A knowledge graph of your machine** | Projects, runtimes, dependencies, packages, tools and AI configuration, linked. See which projects share a dependency and what relies on what. |
  25. | 💥 **Impact analysis** | "What breaks if I remove this?" for any package, runtime or tool, simulated before you touch anything. Try dependency upgrades in an isolated Update Lab. |
  26. | 🤖 **Coding agents, live** | Every Claude Code, Codex, Gemini CLI, Cursor, Aider, Hermes or OpenClaw session with its memory, ports, MCP and dev servers. When an agent exits and leaves a server running, AGASTHY says which session started it and stops it in one reviewed step. |
  27. | 🪙 **Token spend** | Tokens, requests and estimated cost per day, session, project and model, from the agents' own local logs. Counters only, never your prompts. Export to CSV. |
  28. | 🧠 **AI ecosystem** | Installed AI tools, providers, local models, MCP servers in every config, and instruction files (`CLAUDE.md`, `AGENTS.md`, rules) with duplicates, orphans and conflicts. |
  29. | 💾 **Safe disk cleanup** | Rebuildable `node_modules`, `target`, virtualenvs, build output and caches. Only what Git ignores and nothing tracked, moved to a quarantine you can restore from. |
  30. | 🛡️ **Security & snapshots** | Outdated packages, tools of unknown origin, opt-in vulnerability advisories. Snapshot your setup and get the commands to rebuild it on a new machine. |
  31. | 💬 **Ask your machine** | "What is using my RAM?" · "Free 10 GB safely" · "Which repos haven't I touched in 90 days?" · "What breaks if I remove openssl@3?" Works with no AI model; optionally connect Ollama, LM Studio or a cloud model. |
  32. | 🧭 **Insights + menu bar** | A ranked list of what needs attention right now (low disk, swap pressure, token spikes, stale data), one click away in the menu bar. |
  33. ## Tour
  34. | | |
  35. |---|---|
  36. | <img src="docs/screenshots/overview.png" alt="Overview with ranked insights" /><br/>**Overview.** What needs attention now, each with one action. | <img src="docs/screenshots/discovery.png" alt="Discovery: repositories with evidence" /><br/>**Discovery.** Every repo, app, tool and package, with evidence. |
  37. | <img src="docs/screenshots/graph.png" alt="Machine Graph" /><br/>**Machine Graph.** Projects, runtimes and dependencies, connected. | <img src="docs/screenshots/impact.png" alt="Impact Analysis for openssl@3" /><br/>**Impact Analysis.** What breaks before you remove anything. |
  38. | <img src="docs/screenshots/ai-instructions.png" alt="AI Ecosystem instruction files" /><br/>**AI Ecosystem.** Tools, MCP servers and instruction files, with conflicts flagged. | <img src="docs/screenshots/agents.png" alt="Agents page" /><br/>**Agents.** Every coding agent, and what it left running. |
  39. | <img src="docs/screenshots/usage.png" alt="Token Usage page" /><br/>**Token Usage.** Tokens and cost by day, project and model. | <img src="docs/screenshots/processes.png" alt="Processes page" /><br/>**Processes.** Every process with its port and project. |
  40. | <img src="docs/screenshots/storage.png" alt="Storage and cleanup" /><br/>**Storage & Cleanup.** Rebuildable folders into a restorable quarantine. | <img src="docs/screenshots/security.png" alt="Security findings" /><br/>**Security.** Advisories, outdated and unknown-origin software. |
  41. | <img src="docs/screenshots/operator.png" alt="AI Operator answering a question" /><br/>**AI Operator.** Ask your machine; changes are only proposed. | <img src="docs/screenshots/review.png" alt="Review dialog" /><br/>**Safe by design.** Every change is a dry run you confirm. |
  42. <sub>Screenshots and the video use a synthetic demo machine, not real data. `pnpm screenshots` and `pnpm demo:video` regenerate them.</sub>
  43. ## Built to be trusted
  44. - **Local-first.** One SQLite file on your machine. No account, no telemetry, no analytics.
  45. - **Nothing changes without you.** Every action is a dry run first, shows exact targets, needs your confirmation, is verified and logged.
  46. - **Hard limits.** Never `sudo`. Never deletes Git repositories or tracked files. Never touches Docker volumes. Never stops system processes. The AI can only *propose*; it cannot run commands.
  47. - **Evidence, not guesses.** Every fact has a source and a confidence level. What it cannot measure shows as *unavailable*, never as 0.
  48. - **Light.** About 0.4% CPU and under 100 MB in normal use. A 13 MB app.
  49. ## Works with your coding agents
  50. Your agent can ask AGASTHY too. The **AGASTHY skill** gives OpenClaw, Hermes, Claude Code and other agents that read [Agent Skills](https://agentskills.io) real answers about your machine: which projects have uncommitted work, what is on port 3000, what your agents spent in tokens this week, and what breaks if a package goes.
  51. ```text
  52. /plugin marketplace add HMAKT99/Agasthy # Claude Code: skill + MCP server
  53. npx skills add HMAKT99/Agasthy # Codex, Cursor, Gemini CLI and more
  54. hermes skills install HMAKT99/Agasthy/skills/agasthy
  55. gemini extensions install https://github.com/HMAKT99/Agasthy # Gemini CLI: skill + MCP server
  56. ```
  57. Or point your agent at [`llms.txt`](llms.txt): *"Install AGASTHY for me by reading https://raw.githubusercontent.com/HMAKT99/Agasthy/main/llms.txt"*.
  58. It runs `agasthy`, the read-only command-line tool attached to each release, and leaves every change to you. Setup for each agent: [integrations/agent-skill](integrations/agent-skill).
  59. **Prefer MCP?** `agasthy mcp` is a read-only MCP server with nine tools (status, find, entity, impact, shared dependencies, agents, processes, token usage, telemetry) for Claude Desktop, Claude Code, Cursor, VS Code, Codex and any other MCP client:
  60. ```bash
  61. claude mcp add agasthy -- ~/.local/bin/agasthy mcp
  62. ```
  63. Setup for each client: [integrations/mcp](integrations/mcp).
  64. ## Install
  65. > [!IMPORTANT]
  66. > **Expect one security prompt on first launch.** AGASTHY is not yet signed with a paid Apple Developer ID or a Windows code-signing certificate. That does not mean anything is wrong with the download; it means the operating system cannot check who published it.
  67. >
  68. > - **macOS:** "Apple could not verify AGASTHY is free of malware" → **System Settings → Privacy & Security → Open Anyway**.
  69. > - **Windows:** "Windows protected your PC" (SmartScreen) → **More info → Run anyway**.
  70. > - **Linux:** no prompt; just make the AppImage executable.
  71. >
  72. > You only do this once; updates install without it. To check a download yourself, compare it with the `.sha256` file next to it on the release page (`shasum -a 256 <file>` on macOS, `Get-FileHash <file>` on Windows, `sha256sum <file>` on Linux).
  73. **macOS (Apple silicon, macOS 12+)**
  74. **[⬇ Download AGASTHY for macOS (Apple silicon)](https://github.com/HMAKT99/Agasthy/releases/download/v0.1.6/AGASTHY-0.1.6-apple-silicon.dmg)**
  75. Open it and drag **AGASTHY** to **Applications**. The first time, macOS says it cannot verify the developer (the app is not notarized yet): **System Settings → Privacy & Security → Open Anyway**. Then scan your code folder.
  76. Or with [Homebrew](https://brew.sh):
  77. ```bash
  78. brew install --cask hmakt99/tap/agasthy # the app
  79. brew install hmakt99/tap/agasthy-cli # optional: the read-only CLI and MCP server for agents
  80. ```
  81. Using a coding agent without Homebrew? Get [⬇ the CLI](https://github.com/HMAKT99/Agasthy/releases/latest/download/agasthy-cli-macos-aarch64.tar.gz) (unpack it and put `agasthy` on your PATH) or [⬇ the Claude Desktop extension](https://github.com/HMAKT99/Agasthy/releases/download/v0.1.6/agasthy-mcp-0.1.6.mcpb) (double-click it).
  82. **Windows (x64, preview)**
  83. **[⬇ Download AGASTHY for Windows (x64)](https://github.com/HMAKT99/Agasthy/releases/download/v0.1.6/AGASTHY_0.1.6_x64-setup.exe)**
  84. Run it. Windows says "Windows protected your PC" because the installer is not code-signed yet: **More info → Run anyway**. Then scan your code folder.
  85. Using a coding agent? Also get [⬇ the CLI](https://github.com/HMAKT99/Agasthy/releases/latest/download/agasthy-cli-windows-x86_64.zip) (Claude Code, Cursor, Codex; unzip it and put `agasthy.exe` on your PATH) or [⬇ the Claude Desktop extension](https://github.com/HMAKT99/Agasthy/releases/download/v0.1.6/agasthy-mcp-0.1.6.mcpb) (double-click it).
  86. **Linux (x64, preview)**
  87. **[⬇ Download AppImage (any distribution)](https://github.com/HMAKT99/Agasthy/releases/download/v0.1.6/AGASTHY_0.1.6_amd64.AppImage)** · **[⬇ Download .deb (Ubuntu, Debian)](https://github.com/HMAKT99/Agasthy/releases/download/v0.1.6/agasthy_0.1.6_amd64.deb)**
  88. AppImage: `chmod +x AGASTHY_*_amd64.AppImage` and run it. .deb: `sudo apt install ./agasthy_*_amd64.deb`. Then scan your code folder. Built and launch-tested in CI on Ubuntu; feedback from other distributions welcome.
  89. Using a coding agent? Also get [⬇ the CLI](https://github.com/HMAKT99/Agasthy/releases/latest/download/agasthy-cli-linux-x86_64.tar.gz) (unpack it and put `agasthy` on your PATH) or [⬇ the Claude Desktop extension](https://github.com/HMAKT99/Agasthy/releases/download/v0.1.6/agasthy-mcp-0.1.6.mcpb).
  90. AGASTHY lives in the menu bar: closing the window keeps it running, and **Quit** is in the menu-bar menu. Updates are offered in the app, signature-checked, and installed only when you click **Install and restart**.
  91. ## Supported platforms
  92. | Platform | Status |
  93. |---|---|
  94. | macOS 12+ (Apple silicon) | **Supported.** Built and tested on macOS 15 / M2. |
  95. | macOS (Intel) | Expected to work from source; not tested, no download yet. |
  96. | Windows 10/11 (x64) | **Preview.** Installer with each release; built and tested in CI. Known gaps: graceful Stop (Force quit works), WinGet packages, GPU details. [Reports welcome](https://github.com/HMAKT99/Agasthy/issues/new). |
  97. | Linux (x64) | **Preview.** AppImage and `.deb` with each release; built in CI and launch-tested on Ubuntu. Not yet: GPU details. [Reports welcome](https://github.com/HMAKT99/Agasthy/issues/new). |
  98. ## Everything it does
  99. | Area | What AGASTHY does |
  100. |---|---|
  101. | **Live resources** | CPU (total and per core), memory, swap, disk per volume, load average, process count, top processes by memory and CPU, GPU model. Anything it cannot measure is shown as *unavailable* with a reason, never as 0. |
  102. | **Repositories** | In folders **you choose**: finds Git working trees and reports branch, HEAD commit, last commit time, working-tree status (staged / modified / untracked / conflicted), local branch count, remotes (credentials stripped), GitHub origin, languages, frameworks, licence, manifests, size on disk, and duplicate clones of the same project. |
  103. | **Applications** | Bundles in `/Applications`, `~/Applications` and `/System/Applications`, read from `Info.plist`. |
  104. | **CLI tools & runtimes** | A curated catalogue of about 75 developer tools. For each copy on PATH: version, which copy is active and which are shadowed, and how it was installed (for example, it resolves into a Homebrew keg). |
  105. | **Packages** | Read-only inventories from Homebrew (formulae and casks), npm and pnpm globals, uv tools, pip (default `python3`) and `cargo install`. A missing or failing manager is reported as such, never as "0 packages". |
  106. | **Provenance** | Every fact carries evidence and a confidence level (*verified*, *strong*, *probable*, *unknown*). A Git remote read from the repository's own config is *verified*; an upstream taken from a Homebrew formula's homepage is *strong*. Nothing is guessed from names. |
  107. | **Dependencies** | Reads `package.json`, `Cargo.toml`, `pyproject.toml`, `requirements.txt` and `go.mod` (including nested packages), with resolved versions from `package-lock.json`, `Cargo.lock` and `uv.lock`. Shows which dependencies your projects share. |
  108. | **Runtime requirements & impact** | Links projects to the runtimes they declare (`engines.node`, `.nvmrc`, `requires-python`, `rust-version`, `go`, …). Answers *"what breaks if I remove this runtime?"*: for each project, whether it would break, fall back to another copy on PATH, or be unaffected, and what is unknown. Nothing is removed; it is a simulation. |
  109. | **Machine Graph** | An interactive graph of projects, runtimes, dependencies, packages, binaries and upstream projects, with focus, depth and kind filters, search, and the evidence behind every edge. |
  110. | **AI ecosystem** | Finds AI coding assistants, desktop AI apps and local inference engines from evidence on disk; the providers they use (with how strongly each is confirmed); MCP servers in every known config; local models; and AI instruction files (`CLAUDE.md`, `AGENTS.md`, Cursor/Copilot rules, agents, skills, commands) globally and per project, with duplicates, overlaps, orphans and potential conflicts. Credential files are only checked for existence and secrets are redacted. |
  111. | **Processes** | Every process with CPU, memory, listening ports, the project it runs in, and why it is protected if it is. Stop or force-quit your own processes after a reviewed confirmation; system and other users' processes are refused. |
  112. | **Storage & cleanup** | Measures dependency folders and build output in your projects (only those Git ignores and that contain no tracked files) and a fixed list of developer caches. You pick items, review a dry run, and they move to a quarantine you can restore from; space is freed when you delete them permanently. Docker build cache and dangling images can be pruned; volumes never are. |
  113. | **Impact analysis** | "What if I remove X?" for packages, runtimes, dependencies, tools and apps: Homebrew packages that need it (from what installed kegs actually link to), executables and runtimes removed with it, and every project whose runtime would break or fall back, with unknowns and a suggested plan AGASTHY does not run. |
  114. | **Safe Update Lab** | Try a dependency update (npm, pnpm, Cargo) in a separate Git worktree. Install and test steps run only when you approve them (install scripts off by default), and results are copied back only on request. |
  115. | **Snapshots** | Record installed software, repositories (commit, branch, remote) and environment variable names; compare snapshots; list the commands that would bring back what is missing. Metadata only, not a backup. |
  116. | **Security & lifecycle** | Outdated Homebrew packages, tools of unknown origin, and, if you opt in, OSV.dev advisories for npm, PyPI, crates.io and Go packages with exact versions. |
  117. | **AI Operator** | Ask questions in plain language: *what is using my RAM*, *free 10 GB safely*, *which repos have I not touched in 90 days*, *which MCP servers are configured*, *what breaks if I remove openssl@3*. A built-in mode answers common questions with no AI model and sends nothing anywhere. Optionally connect a local model (Ollama, LM Studio, vLLM, LocalAI) or, after a separate opt-in, a cloud model (Anthropic, OpenAI, Gemini, OpenRouter, any OpenAI-compatible endpoint). The model can only read through AGASTHY's typed tools and *propose* changes; every proposal opens the same dry-run review as the rest of the app. |
  118. | **Agents** | Every running coding-agent session (Claude Code, Codex, Gemini CLI, Cursor Agent, Aider, Hermes Agent, OpenClaw and more, plus any process that starts MCP servers) with its process tree, memory, ports and MCP/dev servers; what is still running after an agent exits, with one reviewed action to stop it; Git worktrees agents work in. |
  119. | **Token Usage** | Tokens, requests and estimated cost per day, session, project folder and model, read from Claude Code and Codex logs and Hermes Agent's database. Counters only, never message text. |
  120. | **Insights & menu bar** | A ranked list of what needs attention (low disk, swap pressure, processes agents left running, token spikes, stale data, security findings), and a menu-bar item with the same at a glance. |
  121. | **Audit & privacy** | An append-only audit log of every action, and a privacy page listing exactly which programs AGASTHY may run. |
  122. Repositories, installed packages, binaries on PATH and applications are kept as **separate kinds**. A local clone is never treated as installed software.
  123. Repositories, installed packages, binaries on PATH and applications are kept as **separate kinds**. A local clone is never treated as installed software. Open items are in [ROADMAP.md](ROADMAP.md).
  124. ## Under the hood
  125. Rust workspace, thin Tauri 2 shell, React UI. 290+ Rust tests, Playwright UI tests, CI on macOS, Windows and Linux.
  126. ```
  127. apps/desktop/ React + TypeScript UI; src-tauri/ is a thin command layer
  128. crates/core/ domain model, SQLite store (FTS5), migrations, audit log
  129. crates/platform-adapters/ OS adapters (macOS / Windows / Linux) and the guarded command runner
  130. crates/discovery/ repositories, software, packages, AI ecosystem, token usage
  131. crates/graph/ graph views, shared dependencies, impact analysis
  132. crates/process-manager/ processes, ports, coding-agent sessions
  133. crates/cleanup/ disk analysis, safety checks, quarantine, Docker usage
  134. crates/actions/ typed actions: plan (dry run) → confirm → execute → verify → audit
  135. crates/ai-engine/ AI Operator: typed tools, built-in answers, model providers
  136. crates/snapshots/ environment snapshots, comparison, reconstruction plans
  137. crates/security/ outdated software, unknown provenance, opt-in OSV.dev advisories
  138. crates/update-lab/ Git-worktree labs for trying dependency updates
  139. crates/cli/ `agasthy` headless CLI (JSON output)
  140. ```
  141. More in [docs/architecture.md](docs/architecture.md).
  142. ## Development setup
  143. Requirements: Rust (stable, 1.90+), Node.js 20+, pnpm 10, and on macOS the Xcode Command Line Tools.
  144. ```sh
  145. pnpm install
  146. pnpm dev # runs the desktop app (Vite + Tauri)
  147. ```
  148. Checks:
  149. ```sh
  150. cargo fmt --all --check
  151. cargo clippy --workspace --all-targets -- -D warnings
  152. cargo test --workspace
  153. pnpm typecheck && pnpm lint && pnpm test
  154. pnpm e2e # Playwright UI tests (uses installed Chrome locally)
  155. pnpm check:types # generated TS types match the Rust model
  156. ```
  157. Headless discovery (prints JSON, changes nothing):
  158. ```sh
  159. cargo run -p agasthy-cli -- scan ~/code --depth 4
  160. cargo run -p agasthy-cli -- software
  161. cargo run -p agasthy-cli -- packages
  162. cargo run -p agasthy-cli -- telemetry
  163. cargo run -p agasthy-cli -- impact runtime:/usr/local/bin/python3 --db <file>
  164. ```
  165. Build a DMG (unsigned unless Apple credentials are set; see [docs/releasing.md](docs/releasing.md)):
  166. ```sh
  167. pnpm release:mac # output: dist/AGASTHY-<version>-apple-silicon.dmg
  168. ```
  169. Details: [docs/development.md](docs/development.md).
  170. ## Privacy
  171. No account, telemetry or analytics. The only network requests: an update check against this repository's Releases (can be turned off; sends nothing about your machine), OSV.dev advisory checks if you turn them on, and an AI model endpoint if you configure one (cloud models need a separate opt-in). Repositories are scanned only in folders you add. External programs run only from an allowlist, with fixed arguments, never through a shell. Full details: [docs/privacy.md](docs/privacy.md).
  172. ## Contributing
  173. Contributions are welcome: see [CONTRIBUTING.md](CONTRIBUTING.md), [CODE_OF_CONDUCT.md](CODE_OF_CONDUCT.md) and the [ROADMAP](ROADMAP.md). Found a bug? Settings → About → **Report a problem** prepares a redacted report. Security issues: [SECURITY.md](SECURITY.md), not public issues.
  174. ## Name
  175. *AGASTHY* is the product name. A suggested backronym, not a historical meaning: **A**utonomous **G**overnance, **A**nalysis, **S**ystems, **T**ooling & **H**ybrid intelligence.
  176. ## License
  177. Apache License 2.0. See [LICENSE](LICENSE).
  178. ---
  179. > [!NOTE]
  180. > **Please note: the first launch asks for your OK once.** AGASTHY is free and not yet signed with a paid Apple or Microsoft certificate, so your system shows a warning the first time. This is expected, and the [install steps](#install) show the one click to get past it. Every download is checksummed, built in public by [GitHub Actions](https://github.com/HMAKT99/Agasthy/actions), and in-app updates are signature-checked.

Ratings and comments

Sign in to rate this skill.

Sign in

Free to use. If it’s helped, pass it on.