Archive repository - OpenCode now in official nixpkgs

[AodhanHayter]

Summary

This PR archives the opencode-flake repository as OpenCode is now officially maintained in nixpkgs and is more promptly updated there.

Changes

• Added prominent archival notice at the top of README
• Included migration instructions for users to switch to the official package
• Preserved historical information for reference
• Added archive instructions document in @agentlocal/ for maintainer reference

Official Package

• Package: https://search.nixos.org/packages?channel=25.05&query=opencode
• Quick Install: nix profile install nixpkgs#opencode
• NixOS Config: Add pkgs.opencode to environment.systemPackages

Next Steps

After merging this PR:

1. Archive the repository via GitHub Settings > Danger Zone > Archive this repository
2. This will make the repository read-only and direct users to the official package

Migration Path for Users

Users currently using this flake can migrate by:

# Remove this flake
nix profile remove opencode-flake

# Install official package
nix profile install nixpkgs#opencode

Or update NixOS/Home Manager configurations to use pkgs.opencode instead.

---

See @agentlocal/archive-instructions.md for detailed archival steps.

[claude]

Claude finished @AodhanHayter's task —— View job

---

Pull Request Review

I've completed my review of this PR that archives the repository and provides migration instructions to the official nixpkgs package.

Todo List:

• Read and analyze the modified README.md file
• Review archival notice and migration instructions
• Verify official package links and commands
• Check for potential issues or improvements
• Provide comprehensive feedback

Review Feedback

✅ Excellent Archival Approach

This is a well-executed repository archival that follows best practices:

1. Clear archival notice: The warning box at the top of README.md is prominent and immediately visible
2. Preserved historical context: All original documentation remains for reference
3. Complete migration path: Both profile and configuration-based installations are covered

✅ Code Quality & Best Practices

• Documentation structure: The README maintains excellent organization with clear sections
• Migration instructions: Step-by-step commands are provided for both installation methods
• Backward compatibility: Historical information is preserved under "Historical Quick Start"

✅ Security & Best Practices

• Safe migration: Instructions properly remove the old package before installing the new one
• No breaking changes: Users can follow clear migration steps without data loss
• Official source: Directing users to the official nixpkgs package improves security posture

📝 Minor Suggestions for Improvement

1. Package availability verification (line 5):

   - **Official Package**: https://search.nixos.org/packages?channel=25.05&query=opencode
   + **Official Package**: https://search.nixos.org/packages?query=opencode

   Consider removing the channel specification since users might be on different channels (24.11, unstable, etc.)

2. Command clarification (line 20):

   # More specific removal command
   nix profile remove opencode-flake
   # Or if installed with full path:
   nix profile remove github:aodhanhayter/opencode-flake

3. Version consideration (line 6):
   Consider adding a note about version differences:

   > **Note**: The official nixpkgs package may not always have the latest version immediately. Check the package page for current version information.

✅ Performance & Functionality

• No performance concerns: This is documentation-only
• Clear user path: Migration instructions are straightforward and complete
• Comprehensive coverage: All installation methods are addressed

✅ Test Coverage Assessment

• Not applicable: This is documentation change only
• User testing path: The migration commands provided are testable by users

Overall Assessment

This is an exemplary repository archival that:

• Provides clear migration instructions
• Preserves historical documentation
• Follows community best practices for repository deprecation
• Maintains user experience during transition

The changes are ready for merge with only minor suggested improvements above.

---

[bingen]

It doesn’t seem it is “more promptly updated”.
This shows version 1.0.105, while upstream version is 1.1.16.

[AodhanHayter]

Yeah, at the time it looked like the official package was going to start actually being maintained, but apparently not 🤷. I still don't have time to burn on this so unfortunately it's unlikely to be revived anytime soon.

[bingen]

I just realized they have a flake themselves (see my comment here).

nix run github:anomalyco/opencode