প্রকল্প সম্পর্কে

Edda হলো MDX-এ লেখা ডকুমেন্টেশন সাইট তৈরি ও প্রকাশের জন্য একটি কমান্ড-লাইন টুল, যা "knowledge docs for agents" হিসেবে অবস্থান করে এবং git-নেটিভ ওয়ার্কফ্লো ব্যবহার করে মার্জে প্রকাশ করে। README এটিকে তার প্ল্যাটফর্মের প্রতিটি ডকস সাইটের জন্য ব্যবহৃত একই পদ্ধতি হিসেবে উপস্থাপন করে, যার মধ্যে captain.blode.md অন্তর্ভুক্ত। ইনস্টলেশন npm-এর মাধ্যমে গ্লোবাল: `npm install -g edda-docs`। কুইকস্টার্ট প্রবাহ হলো: ব্রাউজারে GitHub দিয়ে প্রমাণীকরণের জন্য `edda login` (ম্যানুয়ালি পরিচালনার কোনো API কী নেই), একটি ডিরেক্টরিতে ডকস সাইট স্ক্যাফোল্ড করার জন্য `edda new docs --template starter`, এডিটে রিলোডসহ localhost:3030-এ লোকালি সার্ভ করার জন্য `edda dev`, এবং ডিপ্লয়ের জন্য `edda push docs`। ডিপ্লয় করা সাইট নিজস্ব blode.md সাবডোমেইনে লাইভ হয়, যেখানে নাম, নেভিগেশন ও থিম `edda new` যে docs.json ফাইল তৈরি করে তা থেকে নেওয়া হয়। কমান্ড সেটে রয়েছে প্রমাণীকরণ (`login`), স্ক্যাফোল্ডিং (`new`, `minimal` বা `starter` টেমপ্লেটসহ), লোকাল প্রিভিউ (`dev`), কনফিগ যাচাই (`validate`), ডিপ্লয়মেন্ট (`push`), অ্যাকাউন্ট তালিকা (`projects`), এবং PostHog অ্যানালিটিক্স ব্যবস্থাপনা (`analytics` সাথে `get`, `set posthog <key>`, `unset posthog`)। এজেন্ট ব্যবহারের জন্য, README Claude Code বা যেকোনো skills.sh-সামঞ্জস্যপূর্ণ এজেন্টের জন্য একটি ইনস্টলযোগ্য slash command নথিভুক্ত করে `npx skills add mblode/edda -g --all -y` এর মাধ্যমে, এরপর স্ক্যাফোল্ডিং ও ডিপ্লয়মেন্ট সাধারণ ভাষায় চালানো যায়, যেমন `/edda new my-project --template starter` এবং `/edda push docs/ --project my-project`। CI ও অটোমেশন সমর্থন একটি উল্লেখযোগ্য ফোকাস। এনভায়রনমেন্ট ভেরিয়েবলের মধ্যে রয়েছে EDDA_API_KEY / BLODEMD_API_KEY (সংরক্ষিত লগইন সেশনের আগে ব্যবহৃত হয় যাতে CI-তে ইন্টারঅ্যাকটিভ লগইনের প্রয়োজন না হয়), `--project` এর ডিফল্ট হিসেবে EDDA_PROJECT / BLODEMD_PROJECT, এবং API অরিজিনের জন্য EDDA_API_URL / BLODEMD_API_URL। Exit কোড স্থির ও ব্রাঞ্চযোগ্য হিসেবে নথিভুক্ত: 0 সফলতা, 1 ত্রুটি, 2 বাতিল (একটি প্রত্যাখ্যাত প্রম্পটসহ), 3 অবৈধ ইনপুট বা কনফিগ, 4 প্রমাণীকরণ প্রয়োজন, 5 নেটওয়ার্ক ব্যর্থতা। `--json` সহ, ব্যর্থতাগুলো stdout-এ একক লাইন হিসেবে `{"error":true,"code":"AUTH_REQUIRED","message":"...","hint":"..."}` আকারে নির্গত হয়, এবং README মানব-কেন্দ্রিক `message` এর বদলে স্থির `code` ফিল্ডে ব্রাঞ্চ করার পরামর্শ দেয়। অতিরিক্ত নোটে বলা হয়েছে Node.js 24 প্রয়োজন, `push`, `validate` ও `projects` `--json` গ্রহণ করে, `push` নন-ইন্টারঅ্যাকটিভ CI ডিপ্লয়মেন্টের জন্য এনভায়রনমেন্ট থেকে project, API key ও branch মান পড়ে, এবং একটি প্রজেক্ট ড্যাশবোর্ড থেকে GitHub App ইনস্টল করলে প্রতিটি ব্রাঞ্চ পুশে স্বয়ংক্রিয় ডিপ্লয়মেন্ট সক্রিয় হয়। প্রকল্পটি MIT লাইসেন্সপ্রাপ্ত এবং লেখক Matthew Blode।