Skip to content

refactor: simplify project structure and add automated setup logic#2

Merged
fajarhide merged 2 commits into
mainfrom
fix/setup-simply
Mar 31, 2026
Merged

refactor: simplify project structure and add automated setup logic#2
fajarhide merged 2 commits into
mainfrom
fix/setup-simply

Conversation

@fajarhide

@fajarhide fajarhide commented Mar 31, 2026

Copy link
Copy Markdown
Owner

PR Auto Describe

🚀 Summary

This is a major usability release for Heimsense. Adds a complete CLI interface, interactive first-run setup wizard, automatic Claude Code configuration sync, and a full simplified user-focused rewrite of the project README. All existing runtime behaviour remains fully backwards compatible.


🔑 Key Changes

✅ Implemented CLI subcommands: setup, run, sync, version, help
✅ Added interactive setup wizard with automatic Claude Code configuration
✅ Full rewrite of README for clarity and onboarding flow
✅ Upgraded Go runtime from 1.22.0 → 1.25.0
✅ Added build artifacts and temporary files to gitignore


📋 Detailed Breakdown

Application Core

  • Added version string injection support via build ldflags
  • Implemented command routing in main entrypoint
  • First-run detection: run will automatically launch setup wizard if no config exists
  • setup command completes configuration then automatically starts the server
  • sync command propagates manual .env edits to Claude Code user settings
  • Added formatted terminal help output
  • Added golang.org/x/term dependency for safe interactive terminal input

Gitignore

  • Added compiled server binary
  • Added *.rdb redis dump patterns
  • Fixed missing trailing newline at end of file

Documentation

  • Removed 700+ lines of verbose internal documentation, mythology deep dive, and comparison tables
  • Restructured README for new user onboarding: install → configure → run
  • Added clear numbered quick start guide
  • Simplified feature list, removed redundant architecture explanations
  • Updated last updated badge: Mar 25 → Mar 31 2026
  • Added project logo
  • Collapsed low-level API reference into an expandable details section

Dependencies

  • Go module upgraded to 1.25.0
  • Added golang.org/x/term v0.41.0 and transitive sys dependency
  • Added go.sum checksum file

🧠 Notes

All changes are exclusively user facing. This release contains zero changes to the proxy translation logic, API endpoints, or runtime behaviour.


⚠️ Breaking Changes

No breaking changes. All existing environment variables, API contracts, and runtime behaviour are 100% preserved. Existing deployments will continue working unchanged.

@fajarhide fajarhide merged commit 904e9d0 into main Mar 31, 2026
1 check passed
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant