پروژه را می‌خواند، برنامه می‌نویسد و تا آخر کار می‌رود
کار را در پنل گیسو به زبان خودتان می‌خواهید. ایجنت پروژه را بررسی میکند، فهرست کارش را جلوی چشم شما می‌نویسد و قدم‌به‌قدم پیش می‌رود: فایلها را ویرایش میکند، تست‌ها را اجرا میکند و آنچه را خراب شد درست میکند.
-
ویرایش با تأیید شما
هر تغییر به شکل diff می‌آید و شما «پذیرفتن» یا «رد» را می‌زنید. در حالت «ویرایش خودکار» تغییرها مستقیم اعمال می‌شوند و فرمان‌ها همچنان میپرسند.
-
اجرای فرمان با اجازه
هر فرمان پیش از اجرا میپرسد، مگر پیشوندش را در تنظیمات اجازه داده باشید. الگوهای خطرناک، مثل پاک کردن کل پوشه یا push اجباری، در هر حالتی میپرسند.
-
برنامهٔ روشن، نه جعبهٔ سیاه
فهرست کارها همان‌طور که ایجنت پیش می‌رود به‌روز میشود. در حالت «برنامه» فقط می‌خواند و برنامه می‌نویسد؛ ساختن را خودتان با دکمهٔ «شروع ساخت» آغاز میکنید.
وسط کار هم حرف شما را می‌شنود
- وقتی ایجنت مشغول است پیام تازه بفرستید؛ در قدم بعدی به گفتوگو اضافه میشود و لازم نیست کار را متوقف کنید.
- پیام در صف را تا وقتی برداشته نشده ویرایش یا حذف میکنید.
- تغییرات هر نوبت را با «بازگرداندن فایلها» به حالت قبل برمیگردانید.
- فایل را با @ ضمیمه میکنید؛ متن انتخاب‌شده و تصویر، با چسباندن یا کشیدن، هم می‌رود.
موجودی و هزینه، همان‌جا که کار میکنید
- موجودی حساب گیسوی شما به دلار بالای گفتوگو و در نوار وضعیت دیده میشود.
- هر نوبت تعداد توکن و هزینهٔ تقریبی‌اش را نشان می‌دهد؛ /cost جمع را می‌گوید.
- سقف هزینهٔ هر کار را در تنظیمات میگذارید؛ برای ایجنت‌های فرعی هم حساب میشود.
- مدل هر گفتوگو را از فهرستی با اندازهٔ context و قیمت هر میلیون توکن انتخاب میکنید؛ «Gisoo Auto» برای هر پیام مدل مناسب را برمی‌دارد.
مهارت‌های Claude Code و Codex، در همین ویرایشگر
هر پوشه‌ای که یک SKILL.md دارد مهارت است. ایجنت فهرست مهارت‌ها را می‌بیند و هر کدام را که به کار بیاید با ابزار skill بار میکند؛ /skills فهرست را نشان می‌دهد.
-
از پوشه‌های آشنا
مهارت‌های کاربر از پوشه‌های گیسو، Claude، Codex و agents و پلاگین‌های Claude، و مهارت‌های پروژه از همین پوشه‌ها داخل مخزن خوانده می‌شوند.
~/.gisoo/skills~/.claude/skills~/.codex/skills~/.agents/skills.claude/skills.gisoo/skills
-
نصب از گیتهاب با بررسی امنیتی
با «Gisoo: Install skill» از یک پوشه، فایل zip یا tar.gz، یا مخزن گیتهاب نصب میکنید. هر نصب پیش از کپی بررسی میشود: حجم و تعداد فایل، لینک نمادین، دانلودی که به شل می‌رود، مسیر اطلاعات ورود و جمله‌های تزریق دستور. نتیجه را می‌بینید و تأیید میکنید؛ نصب‌کننده هیچ‌چیزی از مهارت را اجرا نمی‌کند.
/skills install owner/repo
-
دستورهای سفارشی
فایل‌های دستور Claude Code و گیسو دستور اسلش می‌شوند، با جای‌گذاری آرگومان‌ها. خط‌های شل داخلشان فقط به شکل متن نشان داده می‌شوند و هرگز اجرا نمی‌شوند.
.gisoo/commands.claude/commands$ARGUMENTS$1 … $9
کار بزرگ را بین چند ایجنت تقسیم میکند
ایجنت اصلی بخش‌هایی از کار را به ایجنت‌های فرعی می‌سپارد و هم‌زمان جلو می‌برد. تعداد هم‌زمان را در تنظیمات محدود میکنید (پیشفرض سه، حداکثر هشت) و سقف هزینهٔ هر کار برای آن‌ها هم حساب میشود.
-
پنل ایجنت‌ها
از نشان بالای گفتوگو یا با /agents باز میشود و ایجنت‌های در حال اجرا بالای کادر پیام هم دیده می‌شوند. متن کامل هر ایجنت تمام‌شده را باز میکنید، متوقفش میکنید یا همان کار را دوباره می‌دهید. نمای درختی ایجنت‌ها در نوار کناری هم هست.
/agents
-
تعریف ایجنت به قالب Claude Code و Codex
ایجنت‌ها را به همان قالب Markdown ایجنت‌های Claude Code در پوشهٔ ایجنت‌های گیسو تعریف میکنید؛ /agents new یک فایل تازه می‌سازد. تعریف‌های TOML ایجنت‌های Codex هم با نام، توضیح، دستورالعمل و مدل خوانده می‌شوند.
.gisoo/agents/<name>.md.codex/agents/*.toml~/.codex/agents/*.toml
-
مدل و سقف جدا برای ایجنت‌های فرعی
برای ایجنت‌های فرعی مدل جداگانه‌ای انتخاب میکنید و حداکثر نوبت هر کدام را تعیین میکنید (پیشفرض ۲۵). این تنظیم‌ها فقط از تنظیمات کاربر خوانده می‌شوند، نه از مخزن.
gisoo.subagentModelgisoo.agents.maxParallelgisoo.agents.maxTurns
گراف کد با Graphify و پیش‌نمایش صفحهٔ وب
ایجنت به‌جای حدس زدن، ساختار پروژه را از خود ویرایشگر و از گراف کد میپرسد، و صفحه‌ای را که می‌سازد همان‌جا باز میکند.
-
گراف کد Graphify
ایجنت از گراف کد میپرسد یک نماد چیست، به چه چیزی وصل است و تغییر یک فایل روی کجا اثر می‌گذارد. اگر Graphify نصب نباشد، یک بار از شما میپرسد (بله، نه، یا هیچ‌وقت) و با اجازهٔ شما در یک ترمینال قابل دیدن نصبش میکند، فقط در پوشهٔ کاری مورد اعتماد. گراف بعد از تغییرها به‌روز میشود و نوار وضعیت می‌گوید تازه است یا کهنه.
gisoo.graphify.autoInstallgraph_querygraph_affected
-
پیش‌نمایش صفحهٔ وب و انیمیشن
صفحه‌ای که می‌سازد روی یک سرور محلی، فقط برای همین دستگاه، باز میشود و با هر ذخیره خودش تازه میشود؛ صفحهٔ HTML یا انیمیشن CSS را همان لحظه می‌بینید. ایجنت می‌تواند با Chromium نصب‌شده روی دستگاه از صفحه عکس بگیرد. فایل‌های مخفی، کلیدها و .git از این سرور بیرون نمی‌روند.
previewscreenshotgisoo.browserPath
-
نماد، تعریف و ارجاع از خود VS Code
تعریف و ارجاع‌های هر نماد را از زبان‌سرور خود ویرایشگر می‌گیرد، نقشهٔ پروژه را می‌بیند و وضعیت، diff، تاریخچه و blame گیت را فقط می‌خواند؛ هیچ فرمان گیتی که چیزی را عوض کند در اختیار ایجنت نیست.
symbolsdefinitionreferencesproject_mapgit
GISOO.md، CLAUDE.md و AGENTS.md را می‌خواند و یادش می‌ماند
قاعده‌های پروژه را یک بار می‌نویسید و ایجنت در هر اجرا می‌خواند؛ نکته‌هایی که وسط کار یاد می‌گیرد هم برای دفعهٔ بعد می‌ماند.
-
فایل‌های دستورالعمل
اول فایل‌های کاربر، بعد پروژه، بعد فایل‌های محلی که بیرون گیت می‌مانند. وارد کردن با @path مثل Claude Code کار میکند و /init یک GISOO.md از روی CLAUDE.md یا AGENTS.md موجود می‌سازد.
GISOO.mdCLAUDE.mdAGENTS.md.github/copilot-instructions.md.cursorrules.windsurfrulesGISOO.local.md
-
حافظهٔ ماندگار هر پروژه
یادداشت‌ها در پوشهٔ حافظهٔ همان پروژه می‌مانند، یک فایل برای هر نکته با یک فهرست. ایجنت اول هر اجرا آن‌ها را می‌خواند و با ابزار memory به‌روزشان میکند. پیام را با # شروع کنید تا بدون اجرای کار یادداشت شود. متنی که شبیه کلید یا رمز باشد ذخیره نمی‌شود.
~/.gisoo/projects/<slug>/memory/.gisoo/memory//memory
-
هم‌خوان با Claude Code
حافظهٔ Claude Code برای همان پوشه فقط خوانده میشود و با «Gisoo: Import Claude Code memory» کپی میشود؛ هیچ‌چیز در پوشهٔ Claude نوشته نمی‌شود. فایل .mcp.json و هوک‌ها در این نسخه پشتیبانی نمی‌شوند. همهٔ این سازگاری با یک تنظیم خاموش میشود.
gisoo.compat.claude
در Cursor، Windsurf و VSCodium هم کار میکند
ویرایشگرهایی که بر پایهٔ VS Code ساخته شده‌اند و افزونههای آن را نصب می‌کنند. ورود با حساب گیسو بعد از تأیید به این ویرایشگرها برمیگردد و اگر باز نشدند، کد ورود را دستی میچسبانید:
- VS Code
- VS Code Insiders
- Cursor
- Windsurf
- VSCodium
- Trae
- Positron
کلید و کد شما کجا می‌رود و کجا نمی‌رود
-
کد باز، مجوز MIT
همهٔ کد افزونه روی گیتهاب است و هر کسی می‌تواند بخواند چه می‌فرستد و چه نمیفرستد. رابط گفتوگو خروجی مدل را با DOMPurify و سیاست سخت‌گیرانهٔ محتوا نشان می‌دهد؛ اسکریپت بیرونی بار نمی‌شود.
github.com/netarz/gisoo-vscode -
کلید فقط در SecretStorage
کلید API در انبار امن خود VS Code می‌ماند و هرگز در تنظیمات، لاگ، فایل جلسه یا نشانی نوشته نمی‌شود. «خروج» آن را از ویرایشگر پاک میکند و از پنل کلیدها هر وقت بخواهید باطلش میکنید.
-
بدون آمارگیری
افزونه فقط با API گیسو حرف می‌زند و کد شما فقط بهعنوان بخشی از پیامی که خودتان شروع میکنید فرستاده میشود. تنها استثنا نصب مهارت از گیتهاب است، آن هم وقتی خودتان اجرایش کنید. آنچه گیسو نگه می‌دارد در صفحهٔ حریم خصوصی نوشته شده.
حریم خصوصی گیسو -
احترام به اعتماد پوشهٔ کاری
در پوشهٔ کاری غیرمعتمد، دستورالعمل، حافظه، دستور و مهارت پروژه خوانده نمی‌شود و ابزار فرمان، گیت و مرورگر در کار نیست. دسترسی به فایل به پوشه‌های باز محدود است و مسیری که بیرون برود یا به .git برسد رد میشود.
-
تنظیمات حساس فقط از تنظیمات کاربر
نشانی API، حالت تأیید، فرمان‌های مجاز، سقف هزینه و مسیر مرورگر فقط از تنظیمات کاربر خوانده می‌شوند؛ فایل تنظیمات یک مخزن نمی‌تواند عوضشان کند. برنامه‌های کمکی مثل گیت و پایتون هم فقط از مسیر مطلق سیستم پیدا می‌شوند، نه از داخل مخزن.
-
تأیید پیش از اجرا
هر فرمان میپرسد مگر پیشوندش مجاز باشد؛ الگوهای مخرب و زنجیره، هدایت یا جایگزینی شل همیشه میپرسند. خواندن صفحهٔ وب به‌طور پیشفرض خاموش است و وقتی روشن باشد برای هر درخواست میپرسد و نشانی‌های محلی و شبکهٔ خصوصی را رد میکند.
مشکل امنیتی را خصوصی به dev@netarz.ir بفرستید، با موضوع «Security: gisoo-vscode»؛ ظرف پنج روز کاری جواب می‌گیرید. فقط آخرین نسخهٔ منتشرشده اصلاح امنیتی می‌گیرد.
نشانی ویژهٔ ایران، با یک گزینه
اگر اتصال با نشانی عادی کند بود یا برقرار نشد، هنگام ورود «نشانی ویژهٔ ایران» را انتخاب کنید یا در تنظیمات افزونه ناحیه را روی ایران بگذارید. درخواست‌ها به نشانی ایران گیسو میروند و بقیهٔ کار فرقی نمی‌کند.
- همان حساب، همان کلید، همان موجودی
- انتخاب هنگام ورود یا با تنظیم gisoo.region
- نشانی دلخواه برای هر سرویس سازگار با OpenAI
نشانی دلخواه هم میشود
با تنظیم gisoo.baseUrl هر نشانی سازگار با OpenAI را می‌دهید. نشانی http غیرمحلی به https تبدیل میشود تا کلید شما در مسیر، باز فرستاده نشود.
راه‌اندازی در چهار قدم
-
نصب افزونه
افزونهٔ «Gisoo — AI Coding Agent» را در ویرایشگر خود نصب کنید. به VS Code نسخهٔ ۱٫۹۰ به بعد نیاز دارد.
-
باز کردن پنل گیسو
آیکون گیسو در نوار فعالیت را بزنید یا کلید میانبر را فشار دهید؛ در مک به‌جای Ctrl از Cmd استفاده میکنید.
Ctrl+Alt+G -
ورود
«ورود با حساب گیسو» را بزنید؛ مرورگر gisoo.pro را باز میکند، «اتصال» را می‌زنید و ویرایشگر خودش ورود را تمام میکند. اگر کلید دارید، با فرمان ورود با کلید وارد شوید.
Gisoo: Sign in with API key -
اولین کار
بنویسید چه می‌خواهید، مثلاً «به فرم ثبت‌نام اعتبارسنجی ایمیل و تستش را اضافه کنید». هزینهٔ هر درخواست به قیمت همان مدل از اعتبار حساب گیسوی شما کم میشود.
به‌زودی در VS Code Marketplace و Open VSX
ساخت کلید APIافزونه رایگان است؛ هزینه فقط قیمت همان مدل
هر نوبت به قیمت فهرستشدهٔ همان مدل، به دلار، از اعتبار حساب گیسوی شما کم میشود.
قیمت هر مدل را در کتابخانهٔ مدلها می‌بینید و اعتبار را از پنل گیسو اضافه میکنید. Claude، GPT، Gemini، DeepSeek، Qwen، Kimi و GLM با یک حساب در دسترس‌اند و مدل را برای هر گفتوگو عوض میکنید.
حداکثر قدم هر اجرا (پیشفرض ۶۰) و سقف هزینهٔ هر کار در تنظیمات شماست؛ وقتی ایجنت به حداکثر قدم برسد، می‌ایستد و میپرسد ادامه بدهد یا نه.
کد باز، مشارکت باز
گیسو برای VS Code با مجوز MIT منتشر میشود؛ کد، تست‌ها و راهنمای مشارکت در همان مخزن است. اشکال و پیشنهاد را در بخش Issues مخزن بنویسید.
پرسش‌هایی که پیش از نصب میپرسند
افزونه رایگان است؟
بله. گیسو برای VS Code متنباز و رایگان است و پولی برای خودش نمیگیرد. هزینهٔ هر درخواست، به قیمت فهرستشدهٔ همان مدل و به دلار، از اعتبار حساب گیسوی شما کم میشود؛ اعتبار را از پنل گیسو اضافه میکنید.
کد من کجا فرستاده میشود؟
فقط به API گیسو، و فقط بهعنوان بخشی از پیامی که خودتان شروع میکنید. افزونه آمار و گزارشی نمیفرستد و با هیچ سرویس دیگری حرف نمیزند؛ تنها استثنا نصب مهارت از گیتهاب است، آن هم وقتی خودتان اجرایش کنید.
در Cursor یا Windsurf هم نصب میشود؟
بله. ویرایشگرهای بر پایهٔ VS Code که افزونههای آن را میپذیرند، از جمله Cursor، Windsurf، VSCodium، Trae، Positron و VS Code Insiders. ورود با حساب گیسو بعد از تأیید به همان ویرایشگر برمیگردد و اگر باز نشد، کد ورود را دستی میچسبانید.
بعد از «اتصال»، ویرایشگر باز نشد. چه کنم؟
در ویرایشگر فرمان «Gisoo: Enter sign-in code» را اجرا کنید و کدی را که صفحه نشان می‌دهد بچسبانید. کد پنج دقیقه و فقط یک بار کار میکند و بدون ویرایشگری که ورود را شروع کرده به درد کسی نمی‌خورد.
بدون اجازهٔ من چیزی اجرا میکند؟
نه. در حالت پیشفرض (پرسیدن پیش از هر کار) هر ویرایش diff میشود و هر فرمان پیش از اجرا میپرسد. فقط فرمانهایی که پیشوندشان را در تنظیمات کاربر اجازه دادهاید بیپرسش میروند، و الگوهای خطرناک یا زنجیرهٔ شل در هر حالتی میپرسند. تغییرات هر نوبت را هم با «بازگرداندن فایلها» برمیگردانید.
CLAUDE.md و مهارت‌های Claude Code من را می‌خواند؟
بله. CLAUDE.md، AGENTS.md، حافظهٔ Claude Code (فقط خواندنی)، دستورهای .claude/commands و مهارت‌های .claude/skills خوانده می‌شوند و چیزی در ~/.claude نوشته نمی‌شود. فایل .mcp.json و هوک‌ها در این نسخه پشتیبانی نمی‌شوند. اگر نمی‌خواهید، تنظیم gisoo.compat.claude را خاموش کنید.
با کدام مدلها کار میکند؟
با مدلهای برنامهنویسی فهرست گیسو: Claude، GPT، Gemini، DeepSeek، Qwen، Kimi، GLM و بقیه، با یک حساب. مدل هر گفتوگو را از فهرستی با اندازهٔ context و قیمت هر میلیون توکن انتخاب میکنید، یا «Gisoo Auto» را میگذارید که برای هر پیام مدل مناسب را بردارد.
راهنماها و صفحه‌های مرتبط
- سرور MCP گیسو ابزارهای گیسو داخل Cursor، Claude Code و دستیارهای دیگر
- ابزارها و کد متنباز افزونهها و کتابخانههایی که کدشان باز است
- کتابخانهٔ مدلها قیمت هر مدل به دلار و تواناییهایش
- مستندات وب‌سرویس، برای برنامهنویسها گرفتن کلید API ساخت کلید در پنل وب‌سرویس، اگر به‌جای حساب گیسو با کلید وارد می‌شوید
- مستندات وب‌سرویس، برای برنامهنویسها Claude Code با گیسو اگر ترجیح می‌دهید در ترمینال با مدلهای گیسو کار کنید
ایجنت گیسو را در ویرایشگر خودتان باز کنید
با حساب گیسو یا کلید API وارد می‌شوید، مدل را انتخاب میکنید و اولین کار را می‌خواهید. هزینه فقط قیمت همان مدل است و موجودی را همان‌جا می‌بینید.
