Notiamo একটি প্রজেক্টের খোলা মন্তব্য ও কাজের ওপর একটি AI এজেন্ট চালাতে পারে। এজেন্ট পরিবর্তন করে, আর আপনার টিমের একজন তা অনুমোদন করেন। রান হতে পারে Notiamo-র সার্ভারে, অথবা আপনার নিজের কম্পিউটারে। এই পেজ দ্বিতীয় উপায়টি নিয়ে: রানার, একটি ছোট প্রোগ্রাম যা আপনি নিজের মেশিনে বসান। এটি এজেন্সির টিমের জন্য।

রানার কী

আপনার সংস্থা Notiamo-তে যেসব এজেন্ট রান সারিতে রাখে, রানার সেগুলোর অপেক্ষায় থাকে। প্রতিটি রানের জন্য সে রিপোজিটরি ক্লোন করে (অথবা WordPress সাইটে সংযুক্ত হয়), রানের নির্দেশনা দিয়ে Claude Code চালু করে, এজেন্ট যা করে তা Notiamo-কে পাঠায়, আর রান শেষ হলে জানায়।

  • তার কাছে Claude-এর কোনো পরিচয়পত্র থাকে না। সে মেশিনে আগে থেকে থাকা claude প্রোগ্রামটি চালু করে। রানারের সেশনগুলো নিজের কনফিগ ফোল্ডার ব্যবহার করে, তাই সেগুলো আপনার নিজের সেশন থেকে আলাদা থাকে। সাইন-ইন Claude Code-এর নিজের, আর Claude Code-ই তা রাখে।
  • এটি Notiamo-র ভেতরে Claude লগইন নয়। Notiamo আপনার Claude অ্যাকাউন্ট কখনো দেখে না, ব্যবহারও করে না। রানার শুধু আপনার নিজের Claude Code চালায়, আপনার মেশিনে, আপনার নিজের কাজের জন্য।

এটি বসান

আপনার লাগবে:

  • Node.js 22 বা নতুন;
  • Claude Code 2.1.314 বা নতুন;
  • git 2.31 বা নতুন;
  • Linux ও WSL2-তে: bubblewrap ও socat (Debian বা Ubuntu: sudo apt install bubblewrap socat)। macOS-এ আর কিছু বসাতে হয় না।

তারপর:

  1. Notiamo-তে সেটিংস › এজেন্ট রান খুলুন। রানার কার্ডে নতুন রানার চাপুন এবং একটি নাম দিন। টোকেনটি কপি করুন। এটি একবারই দেখানো হয়।
  2. মেশিনে এটি চালান:
npx @notiamo/runner init
  1. টোকেনটি পেস্ট করুন। init দেখে নেয় Claude Code কাজ করছে কি না, রানারের জন্য Claude Code-এর সাইন-ইন চালায়, তারপর সার্ভিসটি বসিয়ে চালু করে।
  2. প্রজেক্টে এজেন্ট কোথায় চলে ঘরটি নিজের মেশিন করুন।

init শেষ হলে রানার চলতে থাকে। লগইন বা রিস্টার্টের পর সে নিজে থেকেই আবার চালু হয়।

কমান্ড

কমান্ড কী করে
npx @notiamo/runner init রানার সাজায়: টোকেন, Claude Code-এর সাইন-ইন, সার্ভিস বসানো ও চালু করা।
npx @notiamo/runner@latest update রানারকে সবচেয়ে নতুন সংস্করণে নেয়। টোকেন, নাম ও সাইন-ইন থেকে যায়।
npx @notiamo/runner status সার্ভিস বসানো আছে ও চলছে কি না জানায় এবং লগের শেষ লাইনটি দেখায়।
npx @notiamo/runner logs লগের শেষ ৫০ লাইন দেখায়।
npx @notiamo/runner stop পরের লগইন বা বুট পর্যন্ত সার্ভিস থামায়।
npx @notiamo/runner uninstall সার্ভিস সরিয়ে দেয়। রানারের ফোল্ডার থেকে যায়।
npx @notiamo/runner env <projectId> এই মেশিন একটি প্রজেক্টের রানকে যে env ফাইল দেয়, সেটি বানায় বা দেখায়।
npx @notiamo/runner start সামনের স্তরে চলে। সার্ভিস এটিই চালায়; আপনার এটি খুব কমই লাগে।

সার্ভিসটি macOS-এ launchd এজেন্ট com.notiamo.runner, Windows-এ Scheduled Task “Notiamo runner”, আর Linux-এ systemd ইউজার ইউনিট notiamo-runner।

এক মেশিনে দুটি রানার

npx @notiamo/runner init --profile staging একটি দ্বিতীয়, আলাদা রানার সাজায়। তার নিজের ফোল্ডার (~/.notiamo-runner/profiles/staging) ও নিজের সার্ভিস থাকে। ওই রানারের প্রতিটি কমান্ডে --profile staging যোগ করুন। প্রোফাইলের নামে অক্ষর, সংখ্যা ও ড্যাশ থাকে, ১ থেকে ৩২ অক্ষর।

এজেন্ট কী ছুঁতে পারে, কী পারে না

প্রতিটি রান Claude Code-এর নিজস্ব সেটিংস ফাইল পায়। তিনটি জিনিস এজেন্টকে তার সীমায় রাখে।

ফাইল টুল রানের ফোল্ডারেই থাকে। Claude-এর নিজের ফাইল টুল (পড়া, বদলানো, লেখা, খোঁজা) রানের ফোল্ডারের বাইরের সবকিছু প্রত্যাখ্যান করে। যে কলই অনুমতি চাইবে তা প্রত্যাখ্যাত হয়, কারণ উত্তর দেওয়ার মতো কেউ সেখানে নেই।

শেল কমান্ড চলে অপারেটিং সিস্টেমের স্যান্ডবক্সে। macOS-এ (Seatbelt) এবং Linux বা WSL2-তে (bubblewrap ও socat), এজেন্ট শেলে যে কমান্ডই চালায় তা বদ্ধ গণ্ডির মধ্যে থাকে। স্যান্ডবক্স চালু না হলে রান শুরু হয় না।

মেশিনের কোনো পরিচয়পত্র এজেন্টের কাছে পৌঁছায় না। Claude Code এনভায়রনমেন্ট ভেরিয়েবলের শুধু একটি ছোট তালিকা পায় (PATH, HOME, USER, LOGNAME, SHELL, LANG, LC_ALL, LC_CTYPE, TERM, TMPDIR, TZ, XDG_*, প্রক্সি ও সার্টিফিকেটের সেটিং) এবং সঙ্গে রানের নিজের ভেরিয়েবল। সে কখনো SSH_AUTH_SOCK, GH_TOKEN, GITHUB_TOKEN, NPM_TOKEN, AWS_* বা ANTHROPIC_* পায় না। এজেন্টের git কোনো গ্লোবাল বা সিস্টেম git কনফিগ দেখে না।

শেল স্যান্ডবক্স কী অনুমতি দেয় আর কী দেয় না:

  • পড়া নিষিদ্ধ: অন্য প্রজেক্টের ফোল্ডার (একই সময়ে চলা অন্য রানও), রানারের নিজের ফাইল, এবং আপনার পরিচয়পত্রের ফাইল ও ফোল্ডার (SSH কী, ক্লাউড লগইন, প্যাকেজ রেজিস্ট্রি লগইন, git পরিচয়পত্র)।
  • লেখা অনুমোদিত: শুধু রানের ফোল্ডারে এবং তার পাশে প্রজেক্টের প্যাকেজ ক্যাশ ফোল্ডারে। রানের .git/hooks ও .git/config শুধু পড়া যায়।
  • নেটওয়ার্ক অনুমোদিত: GitHub, npm, Notiamo, WordPress সাইট (WordPress রানের জন্য) এবং রানার কার্ডে এজেন্ট যে অতিরিক্ত হোস্টে যেতে পারবে-এর নিচে আপনি যে হোস্ট যোগ করেন। বাকি সব প্রত্যাখ্যাত।

এজেন্ট কখনো পুশ করে না এবং তার কাছে কোনো পরিচয়পত্র থাকে না। এজেন্টের কাজের পর রানের ব্রাঞ্চ রানার নিজেই পুশ করে।

রান শেষ হলে এজেন্টের ফেলে যাওয়া সব প্রসেস রানার থামিয়ে দেয়, যেমন ডেভ সার্ভার।

macOS-এ কীচেইন

macOS-এর স্যান্ডবক্স কীচেইন পুরোপুরি বন্ধ করে না। তাই রানার যে ইউজার চালায় তার কীচেইনে কোনো GitHub লগইন রাখবেন না (পেলে init সতর্ক করে)। সবচেয়ে নিরাপদ ব্যবস্থা হলো নিজস্ব কীচেইনসহ আলাদা একটি macOS ইউজার।

Windows

সাধারণ Windows-এ শেল স্যান্ডবক্স নেই। তখন কোনো মন্তব্যের লেখা একটি রানকে দিয়ে আপনার নামে যেকোনো কমান্ড চালিয়ে নিতে পারে। রানারকে WSL2-এর ভেতরে চালান। সাধারণ Windows-এ রানার চালু হয় না, যদি না আপনি তার config.json-এ "allowUnsandboxed": true যোগ করেন; এটি শুধু এমন মেশিনে করুন যেখানে আর কিছু রাখা নেই।

একসঙ্গে কয়েকটি রান

রানার কার্ডে আপনি একসঙ্গে রান ঠিক করেন: ১ থেকে ৩। প্রতিটি রান আপনার Claude প্ল্যান ব্যবহার করে, তাই সংখ্যাটি প্ল্যানের সামর্থ্যের মধ্যে রাখুন। একটি প্রজেক্ট একই সময়ে দুবার চলে না: একই প্রজেক্টের দ্বিতীয় রান প্রথমটির জন্য অপেক্ষা করে।

একসঙ্গে চলা প্রতিটি রানের নিজের স্লট ফোল্ডার থাকে। একটি রানের স্যান্ডবক্স অন্য স্লট পড়তে পারে না।

একজন ক্লায়েন্টের জন্য রানার

রানার বানানোর সময় আপনি যাদের জন্য চলে-তে তাকে একটি ওয়ার্কস্পেসে সীমিত করতে পারেন। তখন সে শুধু ওই ক্লায়েন্টের রান নেয়। ক্লায়েন্টের কম্পিউটারে এটি সাজাতে: সেখানে Claude Code বসান, npx @notiamo/runner init চালান, আর রানারের টোকেন পেস্ট করুন। রানের খরচ ওই কম্পিউটারের Claude লগইন বহন করে, তাই যে অ্যাকাউন্টের খরচ বহন করা উচিত তা দিয়ে সাইন ইন করুন।

সেটআপ ও টেস্ট কমান্ড

পরিষ্কার ক্লোনে কোনো প্যাকেজ বসানো থাকে না। এজেন্টকে বলে দিন কীভাবে সেগুলো বসাতে হবে ও কীভাবে টেস্ট করতে হবে। প্রজেক্টের এজেন্ট সেটিংস খুলে সেটআপ কমান্ড ও টেস্ট কমান্ড পূরণ করুন, প্রতিটি এক লাইনে।

  • এজেন্ট সেটআপ কমান্ড তার প্রথম পরিবর্তনের আগে একবার চালায়। উদাহরণ: pnpm install --frozen-lockfile।
  • এজেন্ট টেস্ট কমান্ড প্রতিটি কমিটের আগে চালায়। যে পরিবর্তন তাতে ফেল করে তা ঠিক করা হয় বা ফিরিয়ে নেওয়া হয়। উদাহরণ: pnpm typecheck && pnpm lint।
  • এজেন্ট দুটিই নিজে চালায়, তার অন্য কমান্ডের মতো একই স্যান্ডবক্সে। প্যাকেজ রেজিস্ট্রি অনুমোদিত হোস্টের মধ্যে থাকতে হবে। GitHub ও registry.npmjs.org ডিফল্টভাবে সেখানে আছে। অন্য কোনোটি (PyPI, crates.io, প্রাইভেট রেজিস্ট্রি) রানার কার্ডে এজেন্ট যে অতিরিক্ত হোস্টে যেতে পারবে-এর নিচে যোগ করুন।
  • প্রতিটি প্রজেক্টের ক্লোনের পাশে একটি প্যাকেজ ক্যাশ ফোল্ডার থাকে। npm, pnpm, Yarn, Corepack, Bun, pip, uv ও Composer নিজেদের ক্যাশ সেখানেই রাখে, কারণ স্যান্ডবক্স আপনার হোম ফোল্ডারের সচরাচর জায়গাগুলো বন্ধ রাখে। ফোল্ডারটি প্রজেক্টের রানগুলোর মাঝে থেকে যায় এবং ক্লোনের সঙ্গে চলে যায়। সাধারণ Windows-এ এটি নেই।
  • টেস্ট কমান্ড হালকা রাখুন। যে টেস্টে Docker লাগে তা চলতে পারে না। যে টেস্টে ডেটাবেস লাগে তা চলতে পারে শুধু তখনই, যখন প্রজেক্টের env ফাইল আপনার চালু রাখা কোনো ডেটাবেসের দিকে নির্দেশ করে (নিচে দেখুন)।

এজেন্ট “Notiamo agent” নামে কমিট করে, প্রতিটি বিষয়ের জন্য একটি সাদামাটা লাইন। রানার Claude Code-এর “Co-Authored-By” ট্রেলার ও “Generated with” লাইন বন্ধ করে দেয়, তাই রিপোজিটরিতে কোনো AI সহ-লেখক দেখা যায় না।

আপনার নিজের প্রজেক্টের জন্য একটি পরিবেশ

GitHub প্রজেক্টের রান একটি পরিষ্কার ক্লোন পায়, আর কিছু নয়। আপনার নিজের সফটওয়্যার প্রজেক্টের টেস্টে ডেটাবেস, ফাইল স্টোর, মেইল ক্যাচার ও একটি .env-ও লাগতে পারে। রানার মেশিন সেগুলো একটি সাদামাটা ফাইল দিয়ে একটি প্রজেক্টের রানকে দেয়:

npx @notiamo/runner env <projectId>

<projectId> হলো Notiamo-তে প্রজেক্ট পেজের ঠিকানার শেষ অংশ। কমান্ডটি ~/.notiamo-runner/env/<projectId>.env বানায়, যা শুধু আপনি পড়তে পারেন, এবং তার পথ দেখায়। প্রতি লাইনে একটি KEY=VALUE রাখুন। ওই প্রজেক্টের পরের রান ভেরিয়েবলগুলো তার শেলে পায়, আর এজেন্টকে তাদের নাম বলা হয়, মান কখনো নয়। সরাতে চাইলে ফাইলটি মুছে দিন। ফাইলটি মেশিন ছেড়ে কখনো যায় না: Notiamo জানেই না যে এটি আছে।

ফাইলটি থাকলে macOS-এ রানের শেল 127.0.0.1-এর সার্ভিসেও পৌঁছাতে পারে: আপনার Postgres, ফাইল স্টোর, ডেভ সার্ভার। সেগুলো আপনি চালু রাখেন; এজেন্ট সেগুলো চালু করতে পারে না, আর Docker তার নাগালের বাইরে থাকে। Linux-এ স্যান্ডবক্সের নিজের নেটওয়ার্ক থাকে, তাই সেখানে 127.0.0.1 মেশিনের নয়: সার্ভিসগুলো মেশিনের নেটওয়ার্ক ঠিকানায় বাইন্ড করুন এবং সেই হোস্ট এজেন্ট যে অতিরিক্ত হোস্টে যেতে পারবে-এর নিচে যোগ করুন।

নিয়ম:

  • শুধু ডেভেলপমেন্ট ও টেস্টের মান। এজেন্ট শেল কমান্ড চালায় এবং প্রতিটি ভেরিয়েবল পড়তে পারে। কখনো প্রোডাকশন কী নয়, অন্য কোথাও ব্যবহার করেন এমন পাসওয়ার্ডও নয়।
  • PATH, HOME, প্রক্সি ও সার্টিফিকেটের ভেরিয়েবল, NODE_OPTIONS, NODE_TLS_REJECT_UNAUTHORIZED, NOTIAMO_*, GIT_*, CLAUDE_* ও ANTHROPIC_* উপেক্ষা করা হয়, আর লগ তা জানায়। ফাইলটি এজেন্টের কমান্ড কী দেখে তা বদলাতে পারে, Claude Code কীভাবে Anthropic ও Notiamo-র সঙ্গে কথা বলে তা নয়।
  • ৬ বা তার বেশি অক্ষরের মান Notiamo যে ট্রান্সক্রিপ্ট পায় তাতে [secret] দিয়ে ঢেকে দেওয়া হয়। ছোট মান (1, true) ঢাকা হয় না।
  • কোনো রানারের প্রজেক্টগুলো নিজেদের env ফাইলের মাধ্যমে একই ডেটাবেস ভাগ করলে একসঙ্গে রান ১-এ রাখুন। একই সময়ের দুটি রান তাদের টেস্ট একই ডেটাবেসে চালাবে।

WordPress সাইট

সংযোগটি প্রজেক্টের ওয়েবসাইট প্রবেশাধিকার কার্ডে: একটি অ্যাপ্লিকেশন পাসওয়ার্ড, এবং চাইলে SSH বা FTP। রানার প্রথম সংযোগে SSH সার্ভারের কী মনে রাখে এবং পরে অন্য কী দেখানো সার্ভারকে প্রত্যাখ্যান করে। একটি রান এভাবে চলে:

  1. আগে ব্যাকআপ। SSH থাকলে রানার ডেটাবেস এক্সপোর্ট করে এবং কম্প্রেস করে Notiamo-তে আপলোড করে, সর্বোচ্চ ২০০ MB। Notiamo এটি ৩০ দিন রাখে। শুধু FTP বা API থাকলে ব্যাকআপ হয় না।
  2. এজেন্ট নিচের অনুমোদন তালিকা মেনে কাজ করে।
  3. পরে সাইট যাচাই। রানার সাইট খোলে এবং দেখে সেটি এখনও সাড়া দিচ্ছে কি না।
  4. ব্যর্থ হলে পুনরুদ্ধার। যাচাই ব্যর্থ হলে রানার ডেটাবেস পুনরুদ্ধার করে।

wp-cli দিয়ে এজেন্ট কী চালাতে পারে, গ্রুপ ধরে (প্রজেক্টে ঠিক করা হয়):

  • কনটেন্ট: post *, term *, menu *, media import, option get, option update।
  • ডেটাবেস: search-replace (শুধু পুরোনো ও নতুন লেখা; এটি কখনো users বা options টেবিল স্পর্শ করে না), cache flush, rewrite flush, transient delete।
  • প্লাগইন ও থিম: plugin ও theme, সঙ্গে list, activate, deactivate, update।
  • তথ্য: core version, site list, db size।
  • ফাইল: কোনো wp-cli কমান্ড নয়; এজেন্ট তার ফাইল টুল ব্যবহার করে। সেগুলো স্টাইল, স্ক্রিপ্ট এবং এমন অন্য ফাইল লেখে যা সার্ভার চালায় না।
  • PHP ফাইল (ডিফল্টভাবে বন্ধ): ফাইল টুল PHP-ও লিখতে পারে। PHP ফাইল হলো এমন কোড যা আপনার সার্ভারে চলে, আর WordPress রানে কোনো অনুমোদনের ধাপ নেই: পরিবর্তন সঙ্গে সঙ্গে কার্যকর হয়। এটি শুধু এমন সাইটের জন্য চালু করুন যেখানে মন্তব্য লিখতে পারেন এমন সবাইকে আপনি বিশ্বাস করেন।
  • কখনো নয়, যদি না আপনি “সবকিছুর অনুমতি দিন” বেছে নেন: eval, eval-file, shell, user *, db query|import|reset|drop|export, plugin install, theme install, core update|download।

কী কোথায় থাকে

সবকিছু ~/.notiamo-runner-এ থাকে।

পথ এতে কী আছে
config.json Notiamo-র ঠিকানা, রানারের নাম ও রানার টোকেন। শুধু আপনি পড়তে পারেন।
claude/ রানারের জন্য Claude Code-এর কনফিগ ফোল্ডার: তার সাইন-ইন ও সেশন।
projects/ আপনার প্রজেক্টের কাজের কপি, প্রতিটি স্লটে প্রতি প্রজেক্টে একটি ফোল্ডার। রানার কার্ডে ঠিক করা দিনের সংখ্যা ধরে যে প্রজেক্ট ব্যবহার হয়নি তা সরিয়ে দেওয়া হয়; পরের রান আবার ক্লোন করে।
git/ আপনার রিপোজিটরির রানারের নিজের কপি। এজেন্ট এই ফোল্ডার পড়তেও পারে না, লিখতেও পারে না।
env/ আপনার বানানো env ফাইল, প্রতি প্রজেক্টে একটি।
runs/ চলমান প্রতিটি রানের Claude Code সেটিংস। কোনো গোপন তথ্য নেই। রান শেষ হলে মুছে ফেলা হয়।
runner.log রানার কী করেছে, কোনো গোপন তথ্য ছাড়া।
state.json চলমান রানের আইডি। রিস্টার্টের পর প্রতিটি Notiamo-কে ব্যর্থ বলে জানানো হয়।

রানের গোপন মান (WordPress পাসওয়ার্ড, রানের নিজের টোকেন) রানের সঙ্গে Notiamo থেকে আসে এবং শুধু মেমোরিতে থাকে। এজেন্ট সেগুলো পায় এনভায়রনমেন্ট ভেরিয়েবল হিসেবে, কখনো ফাইলে নয়। এজেন্ট যা প্রিন্ট করে, ট্রান্সক্রিপ্ট আপলোডের আগে তা থেকে সেগুলো সাফ করা হয়।

রানার মেশিনের git পরিচয়পত্র কখনো ব্যবহার করে না। প্রতিটি রান Notiamo থেকে একটি GitHub টোকেন পায়, যা এক ঘণ্টা এবং শুধু রানের রিপোজিটরির জন্য কাজ করে। রানার সেটি মেমোরিতে রাখে এবং নিজের fetch ও push-এ ব্যবহার করে। পুল রিকোয়েস্ট Notiamo খোলে ও মার্জ করে।

রানার বন্ধ করুন

রানার কার্ডে, রানার থামাতে নিষ্ক্রিয় করুন চাপুন, অথবা সরাতে মুছুন। মুছে ফেলা রানারের টোকেন সঙ্গে সঙ্গে কাজ করা বন্ধ করে দেয়।