Aiden McClelland f2142f0bb3 add documentation for ai agents (#3115)
* add documentation for ai agents

* docs: consolidate CLAUDE.md and CONTRIBUTING.md, add style guidelines

- Refactor CLAUDE.md to reference CONTRIBUTING.md for build/test/format info
- Expand CONTRIBUTING.md with comprehensive build targets, env vars, and testing
- Add code style guidelines section with conventional commits
- Standardize SDK prettier config to use single quotes (matching web)
- Add project-level Claude Code settings to disable co-author attribution

* style(sdk): apply prettier with single quotes

Run prettier across sdk/base and sdk/package to apply the
standardized quote style (single quotes matching web).

* docs: add USER.md for per-developer TODO filtering

- Add agents/USER.md to .gitignore (contains user identifier)
- Document session startup flow in CLAUDE.md:
  - Create USER.md if missing, prompting for identifier
  - Filter TODOs by @username tags
  - Offer relevant TODOs on session start

* docs: add i18n documentation task to agent TODOs

* docs: document i18n ID patterns in core/

Add agents/i18n-patterns.md covering rust-i18n setup, translation file
format, t!() macro usage, key naming conventions, and locale selection.
Remove completed TODO item and add reference in CLAUDE.md.

* chore: clarify that all builds work on any OS with Docker
2026-02-06 00:10:16 +01:00
2026-02-02 21:09:19 -07:00
2026-01-27 14:44:41 -08:00
2025-11-07 10:12:05 +00:00
2024-03-20 13:32:57 -06:00
2025-06-25 09:55:50 -04:00
2023-10-05 19:37:31 +00:00
2024-09-26 17:00:52 +00:00


Welcome to the era of Sovereign Computing

StartOS is an open source Linux distribution optimized for running a personal server. It facilitates the discovery, installation, network configuration, service configuration, data backup, dependency management, and health monitoring of self-hosted software services.


StartOS


Running StartOS

Warning

StartOS is in beta. It lacks features. It doesn't always work perfectly. Start9 servers are not plug and play. Using them properly requires some effort and patience. Please do not use StartOS or purchase a server if you are unable or unwilling to follow instructions and learn new concepts.

💰 Buy a Start9 server

This is the most convenient option. Simply buy a server from Start9 and plug it in.

👷 Build your own server

This option is easier than you might imagine, and there are 4 reasons why you might prefer it:

  1. You already have hardware
  2. You want to save on shipping costs
  3. You prefer not to divulge your physical address
  4. You just like building things

To pursue this option, follow one of our DIY guides.

❤️ Contributing

There are multiple ways to contribute: work directly on StartOS, package a service for the marketplace, or help with documentation and guides. To learn more about contributing, see here.

To report security issues, please email our security team - security@start9.com.

🌎 Marketplace

There are dozens of services available for StartOS, and new ones are being added all the time. Check out the full list of available services here. To read more about the Marketplace ecosystem, check out this blog post

🖥️ User Interface Screenshots

StartOS Marketplace StartOS Community Registry StartOS NextCloud Service StartOS BTCPay Service StartOS System Settings StartOS System Settings StartOS System Settings StartOS System Settings

Description
Languages
Rust 52.1%
TypeScript 33.3%
HTML 8.2%
Shell 2.1%
SCSS 2%
Other 2.3%