Engineering behind Firstsun / 首陽問路.
Build useful things. Operate them well. Share what we learn.
Firstsun Dev turns real needs into software, operates the systems that matter, and publishes what survives contact with reality.
Firstsun Journal · Tools · Service status
The projects below are selected because they show different parts of the engineering loop rather than simply being the newest or largest repositories.
Build — Git File Sync
Selective Git synchronization for Obsidian.
Sync individual notes or batches with GitHub, GitLab, and Gitea without requiring a local Git installation. The plugin includes status review, conflict handling, .gitignore support, and mobile-ready workflows.
Obsidian Community Plugin · Read the guide
Extend — Code Insights
A maintained fork for turning AI coding sessions into reusable knowledge.
Firstsun-maintained additions include Kilo Code support, multi-home analysis, personality and recurring-insight views, OpenAI-compatible analysis, reporting workflows, reliability fixes, and deployment operations while preserving upstream attribution and the local-first foundation.
Cloudflare-native identity and application platform.
A privately implemented, publicly operated system built around a shared OIDC identity boundary, auth client SDK, consumer applications, and centralized Playwright E2E testing. The service carries recurring real-world traffic and is continuously monitored, so availability, deployments, and regressions have real operational consequences.
Architecture case study · Service status
Provider-agnostic issue-to-PR engineering automation.
Firstsun Bot is being developed around a human-approved workflow: issue readiness → plan → approval → implementation → pull request → review and merge reconciliation. Tracker and coding-agent providers are isolated behind interfaces so orchestration is not tied to one platform or model.
It is treated as an emerging project until its public documentation, working demo, and real dogfooding evidence justify stronger placement.
Firstsun projects share an operational backbone instead of treating deployment and reliability as an afterthought.
- Shared delivery — reusable GitHub Actions for test, release, and deployment live in
.github - Infrastructure as code — production and self-hosted infrastructure is provisioned with Terraform and configured with Ansible
- Verification — unit, integration, E2E, compatibility, lint, and build checks are applied where they materially reduce risk
- Observable services — monitoring and public service-health visibility are part of the operating model
- Private where appropriate — privileged production source and infrastructure remain private while architecture and operational evidence stay public
infra-config is the private multi-cloud infrastructure and service-operations monorepo behind Firstsun services. It covers Cloudflare, Oracle Cloud, Proxmox, VM lifecycle, storage and backups, tunnels, self-hosted GitHub Actions runners, PostgreSQL, Prometheus monitoring, workflow automation, and container-service operations.
Public infrastructure overview · Service status
- Watermark Bucket Uploader — image processing and S3-compatible object-storage delivery inside Obsidian
- Firstsun Skills — reusable agent skills for engineering workflows
- news-getter — deterministic news scoring, AI-assisted analysis, and a published digest pipeline
- books-mgmt — Kavita collection automation and Google Drive export
- Firstsun Tools — small tools for practice, everyday life, design, and development
The organization profile is intentionally curated rather than a complete repository index. Browse all repositories for workshop and supporting projects.
Firstsun is broader than software. The journal connects engineering, practice, everyday life, and lessons learned along the way; Firstsun Dev is the engineering arm that turns those needs into software and keeps the systems running.
