Skip to content
Back to search

claudia

A tray app that manages your Claude Code settings.json, CLAUDE.md, memory, MCP servers, skills, plugins and marketplaces, globally and for each project folder. The interface runs in your browser at…

Safety scan

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

Badge for your README
findsafeskills safety rating

Markdown

[![findsafeskills safety rating](/api/listings/claude-settings-xyz--claudia/badge.svg)](/listings/claude-settings-xyz--claudia)

HTML

<a href="/listings/claude-settings-xyz--claudia"><img src="/api/listings/claude-settings-xyz--claudia/badge.svg" alt="findsafeskills safety rating" /></a>

Install

i

Install instructions from the README

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

These steps run a script from the network that findsafeskills does not scan.

curl -fsSL https://raw.githubusercontent.com/claude-settings-xyz/claudia/main/install.sh | sh   # macOS, Linux
irm https://raw.githubusercontent.com/claude-settings-xyz/claudia/main/install.ps1 | iex   # Windows

See the [installation docs](https://claudesettings.xyz/docs/installation) for options and uninstalling.

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.

README.md · README · 65 lines · 2 findings marked
  1. # Claudia
  2. ![Claudia: edit every Claude Code setting with a form, not with JSON](.github/banner.png)
  3. A tray app that manages your Claude Code `settings.json`, `CLAUDE.md`, memory, MCP servers, skills, plugins and marketplaces, globally and for each project folder. The interface runs in your browser at http://127.0.0.1:7377.
  4. Website and docs: [claudesettings.xyz](https://claudesettings.xyz)
  5. ## Install
  6. ```bash
  7. curl -fsSL https://raw.githubusercontent.com/claude-settings-xyz/claudia/main/install.sh | sh # macOS, Linux
    • Note: Pipes a downloaded script directly into a shell (curl | sh / wget | bash)
    • Line 12 on GitHub
  8. ```
  9. ```powershell
  10. irm https://raw.githubusercontent.com/claude-settings-xyz/claudia/main/install.ps1 | iex # Windows
  11. ```
  12. See the [installation docs](https://claudesettings.xyz/docs/installation) for options and uninstalling.
  13. ## Layout
  14. | Path | What it is |
  15. | ----------------- | ----------------------------------------------------------------- |
  16. | `main.go` | Entry point: flags, single instance check, HTTP server, tray |
  17. | `tray.go` | Tray menu with Open, GitHub and Quit |
  18. | `icon.go` | Tray icon, drawn at startup |
  19. | `internal/claude` | Reads and writes Claude Code files, lists projects, skills and plugins |
  20. | `internal/schema` | Reads the settings schema from the installed Claude Code |
  21. | `internal/server` | JSON API under `/api` and checks on every request |
  22. | `web` | React, Vite and shadcn interface. `web/embed.go` embeds the build |
  23. | `docs` | Landing page and docs, made with Fumadocs |
  24. | `packaging` | Files for platform packages, such as the macOS `Info.plist` |
  25. | `install.sh` | Installer for macOS and Linux |
  26. | `install.ps1` | Installer for Windows |
  27. ## Commands
  28. ```bash
  29. make build # web, then bin/claudia
  30. make dev # Go API on :7377 and Vite on :5173
  31. make test # go vet and go test
  32. make app # bin/Claudia.app for macOS (menu bar only)
  33. make release # release assets and checksums in bin/release
  34. make docs # docs dev server. cd docs && npm run build writes the static site to docs/out
  35. make settings-schema # refresh the settings list of the docs homepage from your Claude Code
  36. ```
  37. You need Go 1.26 or later and Node.js 24 or later.
  38. ## Workflows
  39. | Workflow | What it does |
  40. | -------- | ------------ |
  41. | [CI](.github/workflows/ci.yml) | Builds the web interface, runs `go vet`, `go test` and the web lint, and builds for Windows and Linux. |
  42. | [Release](.github/workflows/release.yml) | Run it from the Actions tab. It builds the assets on macOS, because the macOS tray needs cgo, and makes a draft release named after the version in `VERSION`, with `SHA256SUMS`. Publish the draft on the Releases page, and GitHub creates the tag. |
  43. | [Docs](.github/workflows/docs.yml) | Builds the docs for pull requests, and publishes them to GitHub Pages from `main`. In the repository settings, set Pages > Source to GitHub Actions, and the custom domain to `claudesettings.xyz`. |
  44. ## Security
  45. The server only listens on 127.0.0.1. It refuses requests with a different `Host` header, which blocks DNS rebinding. API requests must send an `X-Claudia` header. Browsers do not let other websites send that header, so they cannot change your files.
  46. ## License
  47. [MIT](LICENSE)

Ratings and comments

Sign in to rate this skill.

Sign in

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