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

# TermFold TermFold একটি অ্যান্ড্রয়েড অ্যাপ যা ট্যাবলেট এবং ফোনে একটি সম্পূর্ণ Debian 13 পরিবেশ এবং AI কোডিং এজেন্ট সরবরাহ করে। এটি PRoot-এর মাধ্যমে একটি বাস্তব Linux ইউজারল্যান্ড চালায় (রুট প্রয়োজন নেই), Claude Code, Codex, Gemini CLI, OpenCode, Cursor এবং Pi-এর মতো জনপ্রিয় কোডিং এজেন্ট সমর্থন করে এবং Agent Client Protocol (ACP) সমর্থনকারী এজেন্টদের জন্য একটি নেটিভ চ্যাট ইন্টারফেস অফার করে। ## মূল বৈশিষ্ট্য - **সম্পূর্ণ Debian 13 পরিবেশ**: একবার সেটআপের পরে `apt` দিয়ে প্যাকেজ ইনস্টল করুন, Python, Node 22, git, বিল্ড টুল, SSH এবং SCP ব্যবহার করুন। - **বাস্তব Linux প্রকল্প**: প্রকল্পগুলি Debian-এর নিজস্ব স্টোরেজে (`~/projects`) থাকে, তাই সিমলিংক, অনুমতি, এক্সিকিউটেবল, git, npm এবং virtualenv-গুলি ঠিক PC-এর মতো আচরণ করে। - **AI কোডিং এজেন্ট**: টার্মিনালে `claude`, `codex`, `gemini`, `opencode`, `pi` বা `qwen` চালান; প্রতিটি প্রথম ব্যবহারে নিজেকে ইনস্টল করে। ACP সমর্থনকারী এজেন্টরা Markdown রেন্ডারিং, টুল কল, অনুমতি প্রম্পট এবং মডেল/রিজনিং/মোড পিকার সহ একটি নেটিভ চ্যাট UI পায়। - **বিল্ট-ইন ফাইল ম্যানেজার**: ফাইল ব্রাউজ, অনুসন্ধান, সাজান, তৈরি, নাম পরিবর্তন, কপি, মুভ এবং মুছুন। কোড 40+ ভাষা, অনুসন্ধান, আন্ডো এবং Ctrl+S সহ একটি CodeMirror এডিটরে খোলে। ছবি ক্লিপবোর্ড কপি সহ একটি জুমযোগ্য ভিউয়ারে খোলে। - **ফাইল ইমপোর্ট/এক্সপোর্ট**: ফাইল বা ফোল্ডার আপলোড করুন, যেকোনো অ্যাপ থেকে TermFold-এ শেয়ার করুন, ডিভাইস ফোল্ডারে এক্সপোর্ট করুন এবং অ্যান্ড্রয়েডের ফাইল পিকার-এ প্রদর্শিত হন। - **ইন্টিগ্রেটেড ব্রাউজার**: চ্যাটের পাশে ডেভ সার্ভার (`localhost:5173`), প্রকল্প পৃষ্ঠা বা যেকোনো সাইট প্রিভিউ করুন। এজেন্টরাও MCP টুল বা `termfold-browser` কমান্ডের মাধ্যমে বাস্তব ট্যাপ এবং কী সহ ব্রাউজার ব্যবহার করতে পারে। - **সেশন ধারাবাহিকতা**: চ্যাট তাদের শেষ সেশন পুনরায় খোলে, `/resume` আগের সেশন তালিকাভুক্ত করে এবং এজেন্টরা নোটিফিকেশন সহ ব্যাকগ্রাউন্ডে চলতে থাকে। - **ট্যাবলেট-অপ্টিমাইজড**: ফুল-উইডথ Ctrl/Alt/Esc/Tab/arrow কী সারি, ফিজিক্যাল কীবোর্ড সমর্থন, JetBrains Mono ফন্ট, পিঞ্চ টু জুম। - **যেকোনো কিছু পেস্ট করুন**: চ্যাট বা টার্মিনালে ছবি পেস্ট করুন (Claude Code এবং Codex-এর জন্য ফাইল পাথ হিসাবে), দীর্ঘ পেস্ট `.txt` সংযুক্তি হয়ে যায়। - **রুট নেই, Termux নেই, অ্যাকাউন্ট নেই**: সবকিছু অ্যাপের ভিতরে চলে। Apache-2.0-এর অধীনে ওপেন সোর্স। ## ইনস্টলেশন 1. সর্বশেষ রিলিজ থেকে `.apk` ডাউনলোড করুন এবং ইনস্টল করুন। 2. TermFold খুলুন এবং একটি প্রকল্প শুরু করতে **+** ট্যাপ করুন (খালি, Git থেকে ক্লোন করা বা ইমপোর্ট করা)। 3. **Shell** খুলুন — প্রথমবার সেটআপ Debian ডাউনলোড করে (কয়েকশ MB, একবার)। 4. `claude`, `codex`, `gemini`, `opencode` বা `pi` টাইপ করুন, অথবা নেটিভ চ্যাটের জন্য একটি **ACP** সেশন যোগ করুন। Shell-এ একবার সাইন ইন করুন। প্রয়োজনীয়তা: arm64 (বেশিরভাগ ডিভাইস) বা x86_64-এ Android 8.0+, কয়েক GB ফাঁকা স্থান। ## এটি কীভাবে কাজ করে TermFold অ্যাপ স্টোরেজে একটি Debian 13 বেস ইমেজ আনপ্যাক করতে PRoot (ইউজারস্পেস chroot) ব্যবহার করে, একটি স্থায়ী Linux পরিবেশ সরবরাহ করে। প্রকল্পগুলি `~/projects`-এ সাধারণ ডিরেক্টরি। একটি প্রিলোডেড লাইব্রেরি (`/etc/ld.so.preload`) অ্যান্ড্রয়েডের হার্ড-লিংক সীমাবদ্ধতা পরিচালনা করে, যার ফলে dpkg, npm, git, pip এবং tar অপরিবর্তিতভাবে কাজ করে। অ্যাপটি প্ল্যাটফর্মের সীমাবদ্ধতা (W^X, seccomp ফিল্টার, নিষিদ্ধ হার্ড লিংক, CA বান্ডেল নেই) `docs/SHELL-NOTES.md`-এ নথিভুক্ত করে। ## বিল্ডিং ```bash py -3 tools/fetch-shell-runtime.py # PRoot এবং Debian ইমেজ py -3 tools/fetch-ca-bundle.py # CA বান্ডেল ./gradlew :app:assembleDebug ``` রিলিজ বিল্ড স্বাক্ষরিত হয় যখন `termfold-release.jks` বিদ্যমান থাকে এবং `termfold.storePassword` সেট করা থাকে। টেস্ট: `./gradlew :app:testDebugUnitTest`। ## সীমাবদ্ধতা - আর্কিটেকচার CPU-এর সাথে মিলতে হবে (arm64 বা x86_64); কোনো এমুলেশন নেই। - VM নয়: কোনো `systemd`, কার্নেল মডিউল বা র সকেট নেই। - আনইনস্টল বা অ্যাপ ডেটা মুছে ফেললে Debian পরিবেশ এবং প্রকল্প মুছে যায় (কপি রাখতে git-এ পুশ করুন বা এক্সপোর্ট করুন)। ## লাইসেন্স Apache License 2.0। থার্ড-পার্টি উপাদান (PRoot, talloc, Termux টার্মিনাল লাইব্রেরি, Debian বেস ইমেজ, ফন্ট) তাদের নিজ নিজ লাইসেন্সের অধীনে; `THIRD_PARTY_NOTICES.md` দেখুন।