Table of Contents

OpenCode CLI এবং desktop একই coding-agent product-এর client। Terminal interface keyboard-driven কাজ ও script-এর জন্য উপযোগী। Desktop application একটি graphical workspace দেয়। গুরুত্বপূর্ণ তুলনায় প্রতিটি client-এর পেছনের server, project, provider এবং configuration অন্তর্ভুক্ত।

Backend শনাক্ত করার পর interface বেছে নিন। দুটি OpenCode window একই server বা session ব্যবহার করবে এমন নিশ্চয়তা নেই। ভিন্ন server-এ যুক্ত desktop application একটি ভিন্ন execution environment, model label পরিচিত দেখালেও।

মূল বিষয়

  • Terminal কাজের জন্য CLI ব্যবহার করুন এবং non-interactive command চালান।
  • Graphical workspace-এর জন্য desktop ব্যবহার করুন, তবে নির্বাচিত server পরীক্ষা করুন।
  • Provider configuration inference নির্ধারণ করে, interface স্বাধীনভাবে।
  • একই product identity আলাদা server বা version-এ একই session state নিশ্চিত করে না।

পরিধি ও তারিখ: ৬ অক্টোবর ২০২৬-এ official documentation পরীক্ষা করা হয়েছে। এই guide interface তুলনা করে, model quality নয়। আপনার repository, কার্যকর provider connection এবং basic terminal knowledge দরকার। পরীক্ষার জন্য ৪৫ থেকে ৬০ মিনিট রাখুন।

Client ও Server

OpenCode interface ও server আলাদা রাখে। সার্ভার ডকুমেন্টেশন terminal UI-কে client এবং opencode serve-কে standalone server হিসেবে বর্ণনা করে। এই architecture agent-এর সঙ্গে যোগাযোগের একাধিক উপায় দেয়।

Desktop default-ভাবে local server চালু করে। সমস্যা সমাধানের নির্দেশিকা তার opencode-cli sidecar এবং configured server URL-এ connect করার option বর্ণনা করে। Client-এর আচরণ আলাদা হলে prompt বদলানোর আগে connection পরীক্ষা করুন।

Layerযে প্রশ্নের উত্তর দরকার
ClientTerminal UI, desktop app, না non-interactive command?
Agent serverকোন process request গ্রহণ করে?
RepositoryServer কোন directory access করে?
Model providerকোন service inference দেয়?
SessionExisting conversation, না নতুন task?

Server location inference location নয়। আপনার computer-এ থাকা agent server-ও configured hosted model-এ request পাঠাতে পারে। বিপরীতে compatible local inference service নিজের model ও resource requirement-সহ আলাদা process।

Official server reference opencode serve-এর default hostname হিসেবে 127.0.0.1 দেখায়। Local trial-এর সময় service loopback-এ রাখুন:

opencode serve --hostname 127.0.0.1

Authentication, firewall rules এবং server-এর access করা repository path নির্ধারণ করার পরেই wider bind address ব্যবহার করুন।

Agent server, repository files এবং আলাদা inference service-এর সঙ্গে যুক্ত terminal ও desktop client

Agent server এবং inference provider আলাদাভাবে পরীক্ষা করুন

Terminal Interaction ও Automation

opencode

Default command terminal UI খোলে। CLI রেফারেন্স programmatic command-ও নথিভুক্ত করে। Intended repository-তে শুরু করুন এবং edit চাওয়ার আগে selected agent ও model নিশ্চিত করুন।

opencode run "Identify this project's test command. Do not modify files."

Bounded non-interactive request-এর জন্য opencode run ব্যবহার করুন। Appropriate permission policy আলাদাভাবে স্থির করুন। No-change prompt useful direction দেয়, কিন্তু filesystem isolation enforce করে না।

Shell composition গুরুত্বপূর্ণ হলে এই workflow বেছে নিন। Repeatable wrapper-এ request, exit status, relevant output এবং changed files capture করা উচিত। Failure handling স্পষ্ট রাখুন। Empty diff ও success message-এর ব্যাখ্যা verified fix-এর থেকে আলাদা।

Desktop Setup ও Compatibility

উদ্দিষ্ট release-এর জন্য অফিসিয়াল ডাউনলোড পৃষ্ঠা ব্যবহার করুন। OpenCode-এর ডাউনলোড পৃষ্ঠা terminal ও desktop package তালিকাভুক্ত করে। এই পরীক্ষায় ডাউনলোড পৃষ্ঠা v2 terminal package প্রচার করে, আর general documentation-এ পুরনো installation example-ও আছে। Exact client ও backend version লিখে রাখুন, আলাদা release track-এর instruction মেশাবেন না।

ছোট real task দিয়ে desktop interaction মূল্যায়ন করুন। Project খুলুন, server নিশ্চিত করুন, bounded request পাঠান, changed file পরীক্ষা করুন এবং correction চান। Agent-এর কাজ বুঝতে কত effort লাগে তা বিচার করুন। Graphical client আপনার editor ও debugger-এর সম্পূর্ণ replacement ধরে নেবেন না।

Desktop trialপ্রত্যাশিত evidence
Project selectionAgent intended repository শনাক্ত করে
Model selectionProvider ও model trial record-এর সঙ্গে মেলে
Command executionদরকারি runtime ও test পাওয়া যায়
Change inspectionFull patch সহজে খুঁজে review করা যায়
RestartIntended project ও session শনাক্তযোগ্য থাকে

Configuration ও Model Access

OpenCode একাধিক location থেকে configuration merge করে। কনফিগারেশন রেফারেন্স precedence ও non-conflicting setting সংরক্ষণ ব্যাখ্যা করে। শুধু project file নয়, effective model, agent এবং permission তুলনা করুন।

Provider access execution setup-এর অংশ। প্রোভাইডার নির্দেশিকা supported service ও compatible endpoint বর্ণনা করে। Credential, endpoint reachability এবং model tool support গুরুত্বপূর্ণ। অন্য স্থানে চলা server-এর provider ও repository-তে নিজস্ব valid access দরকার।

Client মোট inference cost নির্ধারণ করে না। Matching model ও task-এ billed usage তুলনা করুন। Configuration error-এর কারণে repeated run হিসাব করুন। Local inference ব্যবহার করলে system memory, model format, context size ও runtime setting record করুন। Hosted computation-এর বিনামূল্যের replacement হিসেবে desktop download দেখাবেন না।

Session ও নিরাপদ Switching

ধরে না নিয়ে continuity যাচাই করুন। Client বদলানোর আগে active project ও session record করুন। Destination intended server-এ connect করছে এবং intended history দেখাচ্ছে কি না পরীক্ষা করুন। New session শুরু করলে goal, completed work ও remaining check-সহ concise handover দিন।

একটি checkout-এ concurrent edit এড়িয়ে চলুন। ভিন্ন plan-এর দুটি conversation একই directory target করলে একই file share করে। Independent experiment-এর জন্য separate worktree বা checkout ব্যবহার করুন। Change integrate করার আগে review করুন।

হস্তান্তরের নথি
লক্ষ্য:
বর্তমান শাখা ও কাজের ডিরেক্টরি:
পরিবর্তিত ফাইলসমূহ:
ইতিমধ্যে সম্পন্ন যাচাইসমূহ:
জ্ঞাত ব্যর্থতাসমূহ:
পরবর্তী অনুমোদিত পদক্ষেপ:

এই record handover inspectable করে। Interface issue, missing instruction অথবা environment mismatch আলাদা করতেও সাহায্য করে। Credential record-এ রাখবেন না।

Server Access ও Permissions

Agent server-কে execution service হিসেবে বিবেচনা করুন। Server documentation OPENCODE_SERVER_PASSWORD দিয়ে optional authentication বর্ণনা করে। Machine-to-machine connection-এর আগে access ইচ্ছাকৃতভাবে configure করুন। Reachable agent server harmless static website নয়।

Tool permission আলাদাভাবে review করুন। অনুমতি নির্দেশিকা allow, ask এবং deny behavior সংজ্ঞায়িত করে। Interface trial-এ একই policy প্রয়োগ করুন। কম prompt দেখানো client-কে effective rule পরীক্ষা না করে safer বা more capable মনে করবেন না।

Harmless policy test দিয়ে শুরু করুন। Disposable project-এ allowed file inspection এবং prohibited edit request করুন। Observed behavior যাচাই করে bounded implementation-এ যান। এতে permission assumption testable হয়।

Troubleshooting ও পছন্দ

Symptomপ্রথম inspection
Desktop connection failureSelected server ও local sidecar status
এক client-এ model নেইServer version, provider access ও configuration
ভিন্ন test resultProject directory ও runtime environment
Conversation missingServer ও session identity
Plugin load হওয়া পর্যন্ত কাজ করেPlugin configuration ও release compatibility

Terminal বেছে নিন যদি scripted request ও shell context কাজ সহজ করে। Desktop বেছে নিন যদি graphical project navigation supervision উন্নত করে। Provider ও policy decision এই preference থেকে আলাদা রাখুন।

পরবর্তী ধাপ: CLI বিকল্পের তুলনা -এ terminal alternative তুলনা করুন। Local inference requirement-এর জন্য OpenCode ও Strata নির্দেশিকা পড়ুন। Graphical alternative-এর জন্য GUI বিকল্পের তুলনা ব্যবহার করুন।