gemini cli کی ڈائریکٹری کیسے تبدیل کریں

Google کے اوپن سورس Gemini CLI—وہ ٹرمینل بیسڈ AI ایجنٹ جو Gemini کو آپ کے شیل میں لاتا ہے—لانچ کے بعد تیزی سے پختہ ہوا ہے اور اب امیر کنفیگریشن، پروجیکٹ کانٹیکسٹ فائلیں (GEMINI.md / .gemini)، کسٹم سلیش کمانڈز، اور ورکسپیس ڈائریکٹری کنٹرولز کو سپورٹ کرتا ہے۔ پروجیکٹ GitHub پر فعال طور پر ارتقا پذیر ہے (آفیشل ریپو)، فراخ دل کوٹاز کے ساتھ پبلک پری ویو میں داخل ہو چکا ہے، اور دیگر ڈویلپر ٹولز میں ضم کیا جا رہا ہے (ایڈیٹر انٹیگریشنز اور CI/Actions)۔ لیکن جیسے ہی ٹیمیں پھیلتی ہیں، یا جب آپ ڈرائیوز کے پار یا محدود ماحول (کنٹینرز، کمپنی مینیجڈ لیپ ٹاپس، کلاوڈ شیل، ونڈوز سسٹمز) میں کام کرتے ہیں، آپ جلد ہی ایک عملی سوال سے دوچار ہوتے ہیں: Gemini اپنی فائلیں کہاں محفوظ کرتا ہے، اور آپ کیسے تبدیل کر سکتے ہیں کہ Gemini کن ڈائریکٹریز سے پڑھتا اور لکھتا ہے؟

Gemini CLI کیا ہے؟

Gemini CLI گوگل کا اوپن سورس کمانڈ لائن AI ایجنٹ ہے جو Gemini ماڈلز کی طاقت سیدھے آپ کے ٹرمینل تک پہنچاتا ہے۔ یہ انٹرایکٹو ایجنٹ صلاحیتیں فراہم کرتا ہے جیسے کوڈ اسسٹنس، فائل اور پروجیکٹ انسپکشن، شیل کمانڈز کو چلانا (محفوظات کے ساتھ)، اور ایسے ٹولز کو انٹیگریٹ کرنا جیسے Google Search، Model Context Protocol (MCP) ایکسٹینشنز، اور میڈیا جنریشن ٹولز جو Gemini کے ساتھ آتے ہیں۔ CLI ہلکا پھلکا، اسکرپٹیبل اور ایکسٹینسیبل بننے کے لیے تیار کیا گیا ہے؛ یہ آفیشل ریپوزٹری سے دستیاب ہے اور آسان انسٹالیشن کے لیے پیکیجڈ ہے۔

ڈائریکٹری کیوں اہم ہے

Gemini CLI کنفیگریشن (مثلاً settings.json)، سسٹم پرامپٹس یا کانٹیکسٹ (GEMINI.md)، کیشڈ کریڈینشلز، ٹیلی میٹری شناخت کنندگان، اور دیگر مستقل حالت کو .gemini ڈائریکٹری کے اندر محفوظ کرتا ہے۔ اس ڈائریکٹری کا مقام کنٹرول کرتا ہے:

• CLI کون سی سیٹنگز لوڈ کرتا ہے (گلوبل بمقابلہ پروجیکٹ مخصوص)،
• کون سی “میemory” فائلیں ایجنٹ پڑھے گا،
• کریڈینشلز کہاں کیش ہوتے ہیں (لاگ ان رویے پر اثر انداز)،
• کراس مشین یا CI ری پروڈیوسیبلٹی جب آپ کسٹم کنفیگ ریپو فراہم کرنا چاہیں۔

ڈائریکٹری کو سمجھنا اور (ضرورت پڑنے پر) تبدیل کرنا ملٹی پروجیکٹ ورک فلو، CI، کنٹینرائزڈ ڈپلائمنٹس، اور ٹیموں کے لیے جن کے پاس مرکزی کنفیگ اسٹور ہوتے ہیں، میں مددگار ہے۔

Gemini CLI بطورِ ڈیفالٹ کنفیگریشن کہاں محفوظ کرتا ہے؟

بطورِ ڈیفالٹ CLI .gemini ڈائریکٹری استعمال کرتا ہے۔ زیادہ تر یوزر انسٹالیشنز کے لیے یہ ~/.gemini (ہوم ڈائریکٹری میں .gemini فولڈر) بنتا ہے۔ CLI پروجیکٹ لیول .gemini فائلوں کو بھی سپورٹ کرتا ہے (مثلاً پروجیکٹ روٹ میں .gemini/settings.json) جو اس پروجیکٹ فولڈر سے آپریٹ کرتے ہوئے یوزر سیٹنگز کو اووررائیڈ کرتی ہیں۔ سسٹم لیول سیٹنگز OS مخصوص مقامات (مثال کے طور پر Linux پر /etc/ یا Windows پر %PROGRAMDATA%) سے جب قابلِ اطلاق ہوں تو پڑھی جاتی ہیں۔ عام راستے:

• Linux / macOS: ~/.gemini/ (مثلاً /home/alice/.gemini یا /Users/alice/.gemini)۔
• Windows: %USERPROFILE%\.gemini (مثلاً C:\Users\Alice\.gemini)۔
  .gemini کے اندر آپ عام طور پر settings.json, GEMINI.md, commands/, اور لوکل کیشز پائیں گے۔ CLI پروجیکٹ لیول سیٹنگز کے لیے ہر پروجیکٹ کے روٹ میں .gemini/ فولڈرز بھی پڑھتا ہے۔

یہ ڈیفالٹ اہم ہے: تاریخی طور پر کنفیگ ڈائریکٹری ہوم ڈائریکٹری میں .gemini پر ہارڈ کوڈڈ رہی ہے۔

---

میں Gemini CLI کی کنفیگریشن ڈائریکٹری کیسے بدل یا ری ڈائریکٹ کر سکتا/سکتی ہوں؟

کئی عملی طریقے ہیں — سب سے آسان (مطلوبہ فولڈر میں کام کریں) سے لے کر زیادہ مضبوط (اینورونمنٹ ویری ایبلز یا فائل سسٹم ری ڈائریکٹس) تک۔ یہ اس بات پر منحصر ہے کہ آیا آپ رن ٹائم ماحول کو کنٹرول کرتے ہیں (لوکل ڈیو مشین بمقابلہ CI)، کون سا OS استعمال کر رہے ہیں، اور آپ عارضی یا مستقل تبدیلی پسند کرتے ہیں۔

1) پروجیکٹ لیول .gemini استعمال کریں (ہر پروجیکٹ سیٹنگز کے لیے تجویز کردہ)

اگر آپ ہر پروجیکٹ کے لیے سیٹنگز چاہتے ہیں تو اپنے پروجیکٹ روٹ میں .gemini سب ڈائریکٹری بنائیں اور وہاں settings.json, GEMINI.md، اور دیگر پروجیکٹ فائلیں رکھیں۔ جب آپ اس پروجیکٹ ڈائریکٹری سے چلائیں گے تو Gemini CLI پروجیکٹ سیٹنگز کو ترجیح دے گا:

your-project/├─ .gemini/│  ├─ settings.json│  └─ GEMINI.md└─ src/

جب آپ کا شیل your-project/ پر ہو تو gemini شروع کریں اور CLI اس ٹری سے .gemini فائلیں پک کرے گا (یہ پروجیکٹ کانٹیکسٹ تلاش کرنے کے لیے اوپر کی طرف سرچ کرتا ہے)۔ یہ ہر پروجیکٹ کنفیگریشن کے لیے سب سے محفوظ، واضح طریقہ ہے۔

2) دستاویزی اینورونمنٹ ویری ایبلز استعمال کریں (جب سپورٹڈ ہوں)

Gemini CLI کوڈ بیس اور ڈاکس میں کئی اینورونمنٹ ویری ایبلز کا حوالہ دیا گیا ہے جو رویے کو تبدیل کرنے کے لیے استعمال ہوتے ہیں۔ ان میں سے کچھ سسٹم سیٹنگز یا مخصوص فائل اووررائیڈز کے لیے ہیں:

• GEMINI_API_KEY, GEMINI_MODEL, وغیرہ عام طور پر آتھنٹیکیشن اور ماڈل کے انتخاب کے لیے استعمال ہوتے ہیں۔
• کوڈ بیس اور ڈاکس میں ایسے ویری ایبلز کے حوالے ملتے ہیں جیسے GEMINI_CLI_SYSTEM_SETTINGS_PATH (سسٹم سیٹنگز پاتھ اووررائیڈ کرنے کے لیے) اور کانسٹنٹس جیسے GEMINI_CONFIG_DIR (کوڈ میں استعمال ہونے والا .gemini کا ڈیفالٹ نام)۔ کچھ کمیونٹی ریکوئسٹس اور PRs نے پورے کنفیگ ڈائریکٹری کو ری لوکیٹ کرنے کے لیے GEMINI_CONFIG_DIR اینورونمنٹ ویری ایبل کو شامل کرنے یا ماننے کی تجویز دی ہے۔

مثال (bash / macOS / Linux):

# Temporary for this shell sessionexport GEMINI_CONFIG_DIR="$HOME/custom_gemini_dir"​# Or override system settings path if your install supports it:export GEMINI_CLI_SYSTEM_SETTINGS_PATH="/etc/my-gemini/system.settings.json"​# Then rungemini

PowerShell (Windows):

$env:GEMINI_CONFIG_DIR = 'C:\Users\you\CustomGemini'gemini

اہم وضاحت: تازہ ترین کمیونٹی مباحث اور ایشوز کے مطابق، GEMINI_CONFIG_DIR بعض جگہوں پر ریکوئسٹ اور کوڈ میں ریفرنس کیا گیا ہے — مگر پلیٹ فارم مخصوص بگز اور غیر مستقل رویہ (خاص طور پر Windows پر) رپورٹ ہوا ہے۔ اس کا مطلب ہے کہ اینورونمنٹ ویری ایبل پر مبنی ری ڈائریکشن ہر پلیٹ فارم یا ریلیز میں یکساں طور پر قابلِ اعتماد نہیں ہو سکتی۔ اگر آپ اس پر انحصار کرتے ہیں تو اپنے انسٹالڈ ورژن کے لیے Gemini CLI کے ریلیز نوٹس اور ریپو ایشوز چیک کریں۔

3) سیشن کے اندر Gemini کے ورکسپیس میں ڈائریکٹریز شامل کریں

اگر آپ چاہتے ہیں کہ Gemini اضافی ڈائریکٹریز سے واقف ہو (تاکہ وہ فائلوں کو کانٹیکسٹ کے طور پر پڑھ سکے) تو انٹرایکٹو /directory کمانڈ سیٹ ہے۔ مثال کے طور پر:

/directory add path/to/another/project/directory list

یہ کنفیگ ڈائریکٹری کو نہیں ہلاتا، لیکن ایجنٹ کو اپنی ورکسپیس کانٹیکسٹ میں دیگر ڈائریکٹریز کی فائلیں شامل کرنے دیتا ہے۔ یہ اس وقت مفید ہے جب آپ بغیر اپنی گلوبل کنفیگ بدلے دیگر ریپوزٹریز کا حوالہ دینا چاہتے ہیں۔

4) symlink یا فائل سسٹم bind بنائیں (عملی ورک اراؤنڈ)

اگر CLI اینورونمنٹ اووررائیڈز قبول کرنے سے انکار کرے یا آپ کو ایک قابلِ اعتماد کراس پروسس حل چاہیے، تو فائل سسٹم ری ڈائریکٹ استعمال کریں:

Unix/macOS پر:

# move the original config foldermv ~/.gemini ~/gemini_backup​# create a symlink to your desired locationln -s /path/to/central/gemini-config ~/.gemini

Windows پر (PowerShell ایڈمنسٹریٹو پرامپٹ):

# Move the original directoryMove-Item -Path $env:USERPROFILE\.gemini -Destination C:\GeminiConfigBackup​# Create a junction (administrator)New-Item -ItemType Junction -Path $env:USERPROFILE\.gemini -Target C:\CentralGeminiConfig

یہ طریقہ CLI کو آپ کے مطلوبہ مقام سے پڑھنے پر مجبور کرتا ہے بغیر اس کے کہ CLI میں نیٹو سپورٹ ہو۔ نوٹ: symlinks/junctions کے لیے مناسب فائل سسٹم پرائیویلیجز درکار ہوتے ہیں اور کنٹینر یا Windows ماحول میں ان کا برتاؤ مختلف ہو سکتا ہے۔ احتیاط سے استعمال کریں۔ (“Windows-specific notes” دیکھیں۔)

5) پروسس کے لیے مؤثر ہوم ڈائریکٹری بدلیں (کنٹینر/CI ٹرِک)

جب CI، کنٹینرز، یا ایفیمرل ماحول میں چلتے ہیں، تو آپ gemini پروسس کے لیے $HOME (Unix) یا %USERPROFILE% (Windows) اینورونمنٹ ویری ایبل کو بدل سکتے ہیں تاکہ اس کا ڈیفالٹ ~/.gemini اس راستے پر ریزولو ہو جسے آپ کنٹرول کرتے ہیں:

# Run gemini with a custom HOME (bash)HOME=/ci/workspace/you gemini --some-command​# Or in a container DockerfileENV HOME=/app/userRUN mkdir -p /app/user/.geminiCOPY config /app/user/.gemini

یہ CI ری پروڈیوسیبلٹی کے لیے مفید ہے مگر خیال رہے: HOME کو بدلنا دیگر ٹولز اور آتھنٹیکیشن فلو (مثلاً Google OAuth کیشز) پر اثر انداز ہو سکتا ہے، اس لیے اس تکنیک کو علیحدہ کنٹینرز یا پروسس لیول ریپرز تک محدود رکھیں۔

میں CometAPI کے ذریعے Gemini CLI کیسے انسٹال اور استعمال کر سکتا/سکتی ہوں؟

مختصر جواب: آپ کے پاس دو عملی راستے ہیں — (A) CometAPI کے ذریعے Gemini ماڈلز کو براہِ راست کال کریں (تجویز کردہ اور سب سے آسان)، یا (B) آفیشل Gemini CLI کو CometAPI سے بات کرنے پر آمادہ کریں، یا تو ایسا Gemini-CLI ریلیز استعمال کر کے جو کسٹم base URL سپورٹ کرتا ہو (کچھ ریلیزز / PRs یہ شامل کرتے ہیں)، یا ایک چھوٹا لوکل پراکسی چلا کر جو Gemini-CLI ریکوئسٹس کو CometAPI/OpenAI اسٹائل کالز میں ترجمہ کرے۔

CometAPI کیا ہے؟

CometAPI ایک API ایگریگیشن/گیٹ وے ہے جو سینکڑوں تھرڈ پارٹی ماڈلز (جس میں گوگل کا Gemini فیملی بھی شامل ہے) کو OpenAI اسٹائل HTTP API کے پیچھے ایکسپوز کرتا ہے۔ آپ سائن اپ کرتے ہیں، bearer API key حاصل کرتے ہیں، پھر ایسے اینڈ پوائنٹس کال کرتے ہیں جیسے https://api.cometapi.com/v1/chat/completions۔ CometAPI معیاری bearer tokens کو Authorization ہیڈر میں استعمال کرتا ہے۔

CometAPI کیوں استعمال کریں؟ یہ انٹیگریشن میں آسانی کے لیے آفیشل API کی نسبت کم قیمت پیش کرتا ہے۔ Gemini CLI انسٹالیشن اور یوزج گائیڈ:

میں CometAPI کے ذریعے براہِ راست Gemini ماڈلز کو کیسے کال کروں؟ (تجویز کردہ)

اگر آپ کا مقصد محض Gemini ماڈلز استعمال کرنا ہے اور آپ کو لازمی طور پر Gemini CLI فیچرز کی ضرورت نہیں، تو CometAPI کو براہِ راست کال کرنا سیدھا اور قابلِ اعتماد ہے۔

export COMET_KEY="sk-xxxx"​curl -s -X POST "https://api.cometapi.com/v1/chat/completions" \  -H "Authorization: Bearer $COMET_KEY" \  -H "Content-Type: application/json" \  -d '{    "model": "gemini-2.5-pro",    "messages": [      {"role": "system", "content": "You are a helpful assistant."},      {"role": "user", "content": "Summarize the 3 key benefits of unit tests."}    ],    "max_tokens": 300  }' | jq .

یہ ڈائریکٹ کالز آپ کو اسکرپٹس، ایپس، یا CI میں CometAPI کو شامل کرنے دیتی ہیں، بغیر Gemini CLI پر انحصار کیے۔

کیا میں Gemini CLI کو CometAPI استعمال کرنے پر مجبور کر سکتا/سکتی ہوں؟

کچھ Gemini CLI ورژنز / PRs اینورونمنٹ ویری ایبلز شامل کرتے ہیں تاکہ Gemini API base URL کو اووررائیڈ کیا جا سکے۔ اگر آپ کا انسٹالڈ gemini کسٹم Gemini base URL کنفیگر کرنے + CometAPI key استعمال کرنے کو سپورٹ کرتا ہے، تو آپ اسے CometAPI کی طرف پوائنٹ کر سکتے ہیں اور CometAPI key کو GEMINI_API_KEY کے طور پر سیٹ کر سکتے ہیں (CLI Gemini API key آتھنٹیکیشن کے لیے GEMINI_API_KEY نامی ویری ایبل کی توقع کرتا ہے)۔

مثال:

# example env — *check your gemini-cli docs for exact var names*export GEMINI_API_KEY="sk-xxxxx"                    # CometAPI keyexport GOOGLE_GEMINI_BASE_URL="https://api.cometapi.com/v1"  # if supportedgemini   # run the CLI; it will use the configured base URL

ٹربل شوٹنگ: عام مسائل اور حل

مسئلہ: Gemini دوسرے ریپو میں فائلیں نہیں دیکھ سکتا

1. شروع کرتے وقت کوشش کریں: gemini --include-directories /path/to/repo۔ یا سیشن کے اندر: /directory add /path/to/repo۔
2. اگر ریپو نیٹ ورک ماؤنٹ پر ہے، تو پرمیشنز چیک کریں اور یہ کہ CLI پروسس یوزر فائلیں پڑھ سکتا ہے۔
3. اگر آپ نے .gemini کو ہٹانے کے لیے symlink استعمال کیا ہے، تو تصدیق کریں کہ CLI GEMINI.md اور settings.json کے لیے symlink فالو کرتا ہے (کچھ ورژنز سکیورٹی کی وجہ سے بعض symlinks فالو نہیں کرتے)۔

مسئلہ: gemini Windows پر ~/.gemini بنانے میں ناکام (EPERM)

یہ عموماً اس بات کی علامت ہے کہ آپ کے پروسس کو %USERPROFILE% میں لکھنے کی اجازت نہیں۔ حل:

• ٹرمینل کو Administrator کے طور پر چلائیں یا فولڈر پرمیشنز ایڈجسٹ کریں۔
• symlink کے ذریعے کسٹم کنفیگ لوکیشن سیٹ کریں یا جب سپورٹڈ ہو تو اینورونمنٹ ویری ایبل کے ذریعے (آئندہ GEMINI_CONFIG_DIR سپورٹ پر نظر رکھیں)۔

مسئلہ: cd شیل موڈ کے اندر ورکنگ ڈائر تبدیل نہیں کرتا

یہ کچھ پلیٹ فارمز پر تسلیم شدہ مسئلہ ہے۔ تجویز: Gemini CLI پروسس کے باہر شیل کمانڈز چلانے پر منتقل ہو جائیں یا /directory add کے ذریعے ڈائریکٹریز شامل کریں۔

مسئلہ: CometAPI ماڈل نام توقع کے مطابق نہیں

/v1/models اینڈ پوائنٹ کال کریں اور JSON کو دیکھیں۔ ماڈل IDs اکثر درست ویریئنٹ اسٹرنگز پر مشتمل ہوتے ہیں (مثلاً gemini-2.5-flash-preview-04-17)۔ اپنی ریکوئسٹ میں عین وہی اسٹرنگ استعمال کریں۔

نتیجہ

Gemini CLI کا ڈیفالٹ ڈیزائن معقول، قابلِ دریافت رویے کو ترجیح دیتا ہے: یوزر لیول ڈیفالٹس کے لیے عالمی ~/.gemini اور پروجیکٹ لیول اووررائیڈز کے لیے پروجیکٹ .gemini۔ کمیونٹی مزید نیٹو کنفیگریبیلٹی (واضح اینورونمنٹ ویری ایبلز یا فلیگز) کی جانب بڑھ رہی ہے تاکہ ٹول کو ملٹی یوزر، کنٹینرائزڈ، اور انٹرپرائز ماحول کے لیے زیادہ فرینڈلی بنایا جا سکے۔

Gemini CLI ڈائریکٹری کیسے بدلیں:

جائزہ: Gemini CLI یوزر وائیڈ کنفیگریشن اور کانٹیکسٹ فائلیں .gemini ڈائریکٹری (عام طور پر ~/.gemini) میں محفوظ کرتا ہے۔ آپ CLI کے استعمال کی جانے والی ڈائریکٹری کو متاثر کر سکتے ہیں (1) موجودہ ورکنگ ڈائریکٹری میں پروجیکٹ لیول .gemini پر انحصار کر کے، (2) جہاں سپورٹڈ ہو وہاں اینورونمنٹ ویری ایبلز یا CLI آپشنز استعمال کر کے، (3) انٹرایکٹو سیشن کے اندر ورکسپیس ڈائریکٹریز شامل کر کے، یا (4) جب نیٹو آپشنز غائب ہوں تو فائل سسٹم تکنیکیں (symlinks، bind mounts، یا home/profile ویری ایبلز تبدیل کرنا) استعمال کر کے۔

شروع کرنے کے لیے، Gemini ماڈلز (جیسے Gemini 3 Pro) کی صلاحیتیں Playground میں ایکسپلور کریں اور تفصیلی ہدایات کے لیے API گائیڈ دیکھیں۔ رسائی سے پہلے، براہِ کرم یقینی بنائیں کہ آپ نے CometAPI میں لاگ ان کر لیا ہے اور API key حاصل کر لی ہے۔ CometAPI انٹیگریشن میں مدد کے لیے آفیشل قیمت کے مقابلے میں کہیں کم قیمت پیش کرتا ہے۔

Ready to Go?→ Gemini ماڈلز کا فری ٹرائل !