No description
Find a file
jstamagal 560026c8d3 docs: add AGENTS.md with best practices for Stamos
Add comprehensive agent instructions adapted from finpilot template with best practices specific to bluefin/Stamos structure.

Includes:
- Pre-commit checklist (shellcheck, JSON/YAML validation, conventional commits)
- Bluefin-specific conventions (dnf5, COPR patterns, script ordering)
- Repository structure and where to make changes
- Package management via packages.json
- Build script patterns and examples
- Quick reference for common tasks
- Attribution requirements for AI-assisted commits

Adapted from finpilot AGENTS.md with context updated for full OS fork rather than template layering.

🤖 Generated with [Claude Code](https://claude.com/claude-code)

Co-Authored-By: Claude Sonnet 4.5 <noreply@anthropic.com>
2025-12-19 15:00:39 -05:00
.github chore: delete .github/pull.yml (#3329) 2025-10-10 04:22:05 +00:00
build_files chore: switch to Forgejo built-in container registry 2025-12-19 14:56:03 -05:00
flatpaks feat(dx): add new clapgrep and concessio (#3210) 2025-09-20 13:08:58 -04:00
iso_files chore: switch to Forgejo built-in container registry 2025-12-19 14:56:03 -05:00
just chore: switch to Forgejo built-in container registry 2025-12-19 14:56:03 -05:00
system_files chore: switch to Forgejo built-in container registry 2025-12-19 14:56:03 -05:00
.devcontainer.json feat: Switch to ublue-os devcontainer (#2903) 2025-08-01 15:22:01 +00:00
.gitattributes fix: add gitattributes for proper linguist detection (#1023) 2024-03-13 17:51:40 -04:00
.gitignore Filter out .switcheroo suffix from package versions in changelogs (#3163) 2025-09-10 09:46:22 -04:00
.pre-commit-config.yaml refactor: Reorganize Build Process (#1867) 2024-11-05 04:13:24 +00:00
AGENTS.md docs: add AGENTS.md with best practices for Stamos 2025-12-19 15:00:39 -05:00
artifacthub-repo.yml fix: artifacthub id (#2110) 2025-01-05 10:09:52 -05:00
CLAUDE.md feat: fork bluefin to stamos for private infrastructure 2025-12-19 14:38:50 -05:00
Containerfile chore: switch to Forgejo built-in container registry 2025-12-19 14:56:03 -05:00
CONTRIBUTING.md Add comprehensive Copilot onboarding instructions for improved coding agent efficiency (#3164) 2025-09-09 19:10:51 -04:00
cosign.pub refactor: update cosign public key (#1483) 2024-07-02 13:28:53 -04:00
image-versions.yml chore: switch to Forgejo built-in container registry 2025-12-19 14:56:03 -05:00
Justfile chore: switch to Forgejo built-in container registry 2025-12-19 14:56:03 -05:00
LICENSE Initial commit 2023-03-08 13:39:33 -05:00
MIGRATION.md feat: fork bluefin to stamos for private infrastructure 2025-12-19 14:38:50 -05:00
packages.json chore(dx): Add git-subtree (#3295) 2025-09-30 04:05:01 +00:00
README.md feat: fork bluefin to stamos for private infrastructure 2025-12-19 14:38:50 -05:00
rename-to-stamos.sh feat: fork bluefin to stamos for private infrastructure 2025-12-19 14:38:50 -05:00

Stamos

Stamos is a custom cloud-native desktop operating system forked from Bluefin, running on private infrastructure.

About

This is a private fork of the Bluefin project, customized for personal use on self-hosted infrastructure.

Infrastructure

  • Container Registry: 10.0.0.161 (local registry:2)
  • Git Server: jelly.hedgehog-bortle.ts.net (Forgejo)
  • Organization: jstamagal

Building

# Build base image
just build stamos latest main

# Build developer variant
just build stamos-dx latest main

License

Forked from Universal Blue Bluefin under Apache License 2.0.

Original Project

This project is based on Bluefin by Universal Blue.