👋 Welcome Contributors — Start Here! (Pinned)

[kavix]

🌟 Welcome to Eko — Open Source Contributor Hub

Thank you for your interest in contributing to Eko! This pinned issue is your starting point.

---

🗺️ Where to Start

Step	What to do
1️⃣	Read CONTRIBUTING.md to understand the codebase and workflow
2️⃣	Browse GOOD_FIRST_ISSUES.md for detailed, beginner-friendly tasks
3️⃣	Pick an issue below marked good first issue and comment "I'd like to work on this!"
4️⃣	Fork the repo, create a branch, write tests, and open a PR targeting main

---

🏷️ Available Issues by Difficulty

🟢 Easy (Great for first-timers)

• Generate shell completion scripts (eko completion) #101 — Shell completion scripts (eko completion)
• Add eko config command to manage global settings #105 — eko config command for global settings
• Restore environment variables automatically after eko restore #106 — Better env restore UX after eko restore
• Add eko size command to report snapshot disk usage #108 — eko size snapshot disk usage report
• Add eko init --from <snapshot-id> flag to bootstrap a project from a snapshot #111 — eko init --from <id> bootstrap flag
• Write a GitHub Actions CI workflow example for projects using Eko #112 — GitHub Actions CI integration guide (docs)

🟡 Medium (Some Go/CLI experience helpful)

• Add eko diff <id1> <id2> terminal file diff command #100 — eko diff <id1> <id2> terminal diff view
• Add interactive terminal picker for eko restore and eko summary #102 — Interactive terminal picker for restore/summary
• Support custom snapshot aliases and tags (eko tag) #103 — Snapshot aliases and tags (eko tag)
• Slack and Discord Webhook notifications for AI summaries #104 — Slack/Discord webhook notifications
• Show real-time progress bar during eko save and eko restore #107 — Real-time progress bar during save/restore
• Add eko copy command to extract a snapshot into a new directory #109 — eko copy snapshot to new directory
• Add eko search command to search file contents across snapshots #110 — eko search file contents across snapshots

---

💬 Questions?

Feel free to ask in any issue thread. Maintainers will review PRs promptly and provide constructive feedback.

Happy coding! ✦