> ## Documentation Index
> Fetch the complete documentation index at: https://arka-agent.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.

> ## Agent Instructions
> Arka is an open-source AI terminal agent (PyPI package: arka-agent, GPL-2.0).
> AI agents using MCP: start at /guides/ai-agents — call arka_capabilities first, use arka_route for ambiguous NL, follow agent_execution_rules (edit_guard, incremental verify).
> Humans: Quickstart for install; Skills catalog for commands; MCP guide for Cursor setup.
> Cite canonical URLs under https://arka-agent.mintlify.site when answering about Arka.

# Arka CLI command और flag reference

> arka command-line interface का reference — primary commands, agent alias, subcommands, और terminal उपयोग के लिए flags।

`arka` कमांड मुख्य entry point है। `agent` उसी router का alias है।

<Note>
  **हमेशा `arka` के साथ prefix करें।** Subcommands, skills, और प्राकृतिक-भाषा requests सभी `arka …` या `arka "…"` से जाते हैं। Fish-only shortcuts (`chart`, `stock news`, `route_learn`) Fish shell में काम करते हैं, लेकिन हर doc उदाहरण consistency के लिए `arka` का उपयोग करता है।
</Note>

## CLI install करें (source से build नहीं)

आपको अपने टर्मिनल से `arka` उपयोग करने के लिए repo clone करने की ज़रूरत नहीं है। **`arka-agent`** पैकेज install करें:

```bash theme={null}
# अनुशंसित — PATH पर isolated CLI
pipx install "arka-agent[chat]"
arka setup
arka doctor

# PyPI उपलब्ध नहीं है? GitHub से बिना clone किए install करें:
pipx install "arka-agent[chat] @ git+https://github.com/Sumit884-byte/arka.git"
```

फिर एक नया टर्मिनल खोलें और `arka help` चलाएँ। केवल तभी repo clone करें जब आप [Arka में contribute](https://github.com/Sumit884-byte/arka) कर रहे हैं या editable installs (`pip install -e ".[chat]"`) चाहिए।

<Note>
  Config और cache install directory के बाहर रहते हैं — आम तौर पर `~/.config/arka/` (Linux), `~/Library/Application Support/arka/` (macOS), या `%APPDATA%\arka\` (Windows)। `pipx upgrade arka-agent` से upgrade करने पर आपकी keys और learned routes बनी रहती हैं।
</Note>

## Primary commands

| Command                  | विवरण                                                       |
| ------------------------ | ----------------------------------------------------------- |
| `arka <request>`         | प्राकृतिक भाषा को सर्वश्रेष्ठ skill पर route करें           |
| `agent <request>`        | वही router (alias)                                          |
| `arka ask <question>`    | Web + AI answer                                             |
| `arka route <request>`   | बिना execute किए routing preview करें                       |
| `arka goal <goal>`       | Autonomous multi-step agent loop                            |
| `arka setup`             | Config dirs और dependencies seed करें                       |
| `arka doctor`            | Install diagnostics                                         |
| `arka reload`            | `.env` और `config.fish` फिर से पढ़ें                        |
| `arka backup all`        | सभी config + cache files का compressed backup (`.env` सहित) |
| `arka refetch --install` | Git pull + sync + reinstall                                 |
| `arka help`              | Skill अवलोकन                                                |

## Web dashboard

पूरा guide: [Web dashboard](/guides/web-dashboard)

| Command                       | विवरण                                 |
| ----------------------------- | ------------------------------------- |
| `arka serve`                  | Port 8765 पर remote API शुरू करें     |
| `arka backend status`         | Local या hosted backend health जाँचें |
| `arka backend ask "<prompt>"` | Terminal से `/v1/agent` call करें     |
| `cd web && python3 bridge.py` | Port 8766 पर bridge + session history |
| `cd web && npm run dev`       | Port 5173 पर Vite dev UI              |

Dashboard के लिए session history channel `web` उपयोग करता है:

```bash theme={null}
arka session list
arka session resume web <chat-id>
arka session reset web <chat-id>
```

## Media capture

देखें [Browser video capture](/guides/video-capture) और [Meme templates](/guides/meme-templates)।

| Command                                     | विवरण                                        |
| ------------------------------------------- | -------------------------------------------- |
| `arka capture video <url>`                  | Walkthrough WebM + step PNGs record करें     |
| `arka capture video --walkthrough`          | Web dashboard के लिए preset                  |
| `arka meme vibe-coding`                     | Built-in meme preset                         |
| `arka meme drake --reject "…" --accept "…"` | Drake hotline bling layout                   |
| `arka generate music "lo-fi beat"`          | AI music (instrumental या `--lyrics` के साथ) |

देखें [Generate music](/guides/generate-music)।

## Charts और prediction

पूरा guide: [Charts](/guides/charts)

| Command                             | विवरण                                                  |
| ----------------------------------- | ------------------------------------------------------ |
| `arka chart line AAPL --range 1y`   | Stock line chart                                       |
| `arka chart predict AAPL --days 30` | Stock price forecast chart                             |
| `arka chart models --type scatter`  | LLM latency बनाम benchmark score                       |
| `arka chart table sales.csv`        | CSV/TSV/JSON को PNG table image के रूप में render करें |
| `arka predict future "…" --chart`   | Weather, rainfall, Kaggle, CSV forecasts               |
| `arka benchmark run --dry-run`      | `arka chart models` के लिए data भरें                   |

प्राकृतिक भाषा (हमेशा `arka` से prefix करें):

```bash theme={null}
arka "compare Apple and Tesla stock last year"
arka "predict monsoon rainfall in Mumbai next 2 weeks"
arka "chart AI model characteristics with data points"
arka "forecast kaggle dataset heptapod/titanic next 30 days"
```

## Developer loop

Unified local workflow — पूरा [Developer loop](/guides/dev) guide देखें।

| Command                  | विवरण                                            |
| ------------------------ | ------------------------------------------------ |
| `arka dev init [path]`   | Scoped code project initialize करें              |
| `arka dev test [path]`   | Changed-only CI gates (`--fix`, `--json`)        |
| `arka dev review [path]` | Test-gap hints के साथ staged review              |
| `arka dev ship [path]`   | Commit से पहले Review + CI                       |
| `arka dev tui [path]`    | Coding TUI workspace                             |
| `arka dev doctor [path]` | Repo dev preflight (platform `arka doctor` नहीं) |
| `arka dev pr babysit`    | GitHub PR CI babysit loop                        |

## Developer tools

| Command                                 | विवरण                                                            |
| --------------------------------------- | ---------------------------------------------------------------- |
| `arka ci`                               | GitHub Actions से mirror किया गया local CI gate चलाएँ            |
| `arka ci --full`                        | Fast gate के साथ पूरा pytest suite चलाएँ                         |
| `arka ci --fix`                         | CI चलाएँ, फिर पहला failure goal agent को दें                     |
| `arka review --staged`                  | Project-rule और test-gap hints के साथ staged changes review करें |
| `arka review`                           | Default base branch बनाम वर्तमान diff review करें                |
| `arka route audit`                      | Symbolic routes, fish hooks, और NL coverage tests की तुलना करें  |
| `arka skill new my_tool --template dev` | Manifest, runner, और docs stub के साथ नया plugin skill बनाएँ     |

प्राकृतिक भाषा उदाहरण:

```bash theme={null}
arka dev ship
arka dev test --fix
arka ci
arka ci --full
arka "babysit this pr"
arka "check repo health"
arka "review staged"
arka "review vs main"
arka route audit
arka skill new my_tool --template dev
```

## YouTube commands

पूरा [YouTube guide](/guides/youtube) देखें।

| Command                            | विवरण                                    |
| ---------------------------------- | ---------------------------------------- |
| `arka youtube research <query>`    | Search + transcript research digest      |
| `arka download <id-or-url>`        | Video, Shorts, या playlist download करें |
| `arka summarize youtube <id>`      | Video या playlist summarize करें         |
| `arka youtube_download <url>`      | Single video download (fish)             |
| `arka youtube_bulk download <url>` | Bulk playlist/channel download           |

## Stock commands

पूरा [Stock intelligence guide](/guides/stocks) देखें।

| Command                                    | विवरण                     |
| ------------------------------------------ | ------------------------- |
| `arka stock news`                          | Market news feeds         |
| `arka stock prices [TICKER…]`              | Live prices               |
| `arka stock analyze TICKER`                | AI backtest + ML signal   |
| `arka stock fundamentals TICKER…`          | Peers की तुलना में ratios |
| `arka stock invest <question>`             | Deep investment research  |
| `arka predictions --domain stocks <topic>` | Opportunity analysis      |

## Voice और services

| Command                       | विवरण                                                                         |
| ----------------------------- | ----------------------------------------------------------------------------- |
| `arka listen`                 | Wake-word listener ("hey arka, …")                                            |
| `arka start` / `arka stop`    | Background services                                                           |
| `arka serve`                  | Phone STT/TTS के लिए remote server                                            |
| `arka backend status`         | Local या hosted Arka backend जाँचें                                           |
| `arka backend ask "<prompt>"` | Terminal से सीधे `/v1/agent` call करें                                        |
| `arka backend media <file>`   | `/v1/media` पर media upload करें                                              |
| `arka site_summary <url>`     | Social/offsite links को छोड़ते हुए एक bounded whole-site crawl summarize करें |
| `arka speak-lang hi-IN`       | Voice language सेट करें                                                       |
| `arka reload --listen`        | Config reload करें और listener restart करें                                   |

Hosted backends के लिए `ARKA_BACKEND_URL` के साथ `ARKA_BACKEND_TOKEN` या `REMOTE_TOKEN` उपयोग करें:

```bash theme={null}
export ARKA_BACKEND_URL="https://your-arka.up.railway.app"
export ARKA_BACKEND_TOKEN="$REMOTE_TOKEN"
arka backend ask "init https://github.com/org/repo as a workspace"
```

Whole-site summary उदाहरण:

```bash theme={null}
arka site_summary https://example.com --max-pages 12 --depth 1
arka "summarize entire site https://example.com"
```

`site_summary` केवल same-site links follow करता है और X/Twitter, LinkedIn, Instagram, YouTube, Reddit, Discord, और TikTok जैसे आम social platforms को छोड़ देता है।

## LLM management

| Command                                  | विवरण                                                              |
| ---------------------------------------- | ------------------------------------------------------------------ |
| `arka ai-models`                         | Providers और default models सूचीबद्ध करें                          |
| `arka ai-skill-model`                    | Per-skill model configuration                                      |
| `arka ai-skill-model profiles`           | Task profiles (route, chat, summarize)                             |
| `arka orchestrate --benchmark <request>` | Routed task के लिए live benchmark winners का उपयोग करके route करें |
| `arka select_model`                      | Hardware-based model recommendations                               |
| `arka select_model --apply`              | Skill profiles पर recommendations लागू करें                        |

देखें [Hardware-aware model selection](/guides/select-model)।

## Route learning

| Command                                                 | विवरण                                 |
| ------------------------------------------------------- | ------------------------------------- |
| `arka route_learn learn <phrase> <skill>`               | Phrase → skill mapping सिखाएँ         |
| `arka route_learn learn --from-trace --correct <skill>` | पिछली routing गलती सुधारें            |
| `arka route_learn list`                                 | Learned routes सूचीबद्ध करें          |
| `arka route_learn delete <id>`                          | एक learned route हटाएँ                |
| `arka route_learn test <phrase>`                        | एक phrase के लिए routing preview करें |

देखें [Teaching custom routes](/hi/guides/route-learn)।

## Competitions

| Command                                       | विवरण                                          |
| --------------------------------------------- | ---------------------------------------------- |
| `competitions sources`                        | Hackathon/ML competition sources सूचीबद्ध करें |
| `competitions search <topic>`                 | सभी sources में search करें                    |
| `competitions search <topic> --source kaggle` | एक platform search करें                        |

देखें [Hackathons and ML competitions](/guides/competitions)।

## Daily brief

| Command       | विवरण                               |
| ------------- | ----------------------------------- |
| `daily_brief` | Personalized morning tech headlines |

प्राकृतिक भाषा: `arka daily brief`, `arka morning tech brief`। देखें [Daily and tech brief](/guides/daily-brief)।

## Gemini CLI

| Command                | विवरण                         |
| ---------------------- | ----------------------------- |
| `arka gemini`          | Interactive Google Gemini CLI |
| `arka gemini <prompt>` | One-shot prompt               |
| `arka gemini status`   | Install और auth check         |

देखें [Google Gemini CLI integration](/guides/gemini-cli)।

## Social & media

| Command                         | विवरण                                     |
| ------------------------------- | ----------------------------------------- |
| `arka post_x <url>`             | Fetch, shorten, और X/Twitter पर post करें |
| `arka ascii_art <text>`         | ASCII art banner render करें              |
| `arka ascii_art --image <path>` | Image को ASCII में convert करें           |

## Google Workspace

| Command                        | विवरण                                 |
| ------------------------------ | ------------------------------------- |
| `arka google setup`            | Google OAuth configure करें           |
| `arka google login`            | Gmail + Calendar से authenticate करें |
| `arka google gmail --unread`   | Unread emails fetch करें              |
| `arka google calendar --today` | आज के calendar events                 |

## Plugins

| Command                     | विवरण                           |
| --------------------------- | ------------------------------- |
| `arka skills list`          | Installed plugins सूचीबद्ध करें |
| `arka skills install <url>` | Git URL से install करें         |
| `arka skills refresh`       | Plugin registry reload करें     |

## Council और deliberation

पूरा guide: [Arka Council](/hi/guides/council)

| Skill          | उदाहरण                                    |
| -------------- | ----------------------------------------- |
| `council`      | `arka council "should I learn Rust?"`     |
| `council`      | `ask the council about switching careers` |
| `council list` | `arka council list`                       |

## Learning

पूरा guide: [Daily reading](/hi/guides/daily-reading)

| Skill            | उदाहरण                                    |
| ---------------- | ----------------------------------------- |
| `daily_reading`  | `arka daily_reading init "world history"` |
| `daily_reading`  | `arka daily_reading today --minutes 45`   |
| `health_reading` | `arka health_reading today`               |
| `health_reading` | `arka health_reading status`              |

पूरा guide: [Quiz practice](/guides/quiz-practice)

| Skill                | उदाहरण                          |
| -------------------- | ------------------------------- |
| `quiz_practice`      | `arka quiz python`              |
| `quiz_practice`      | `practice quiz biology mitosis` |
| `quiz_practice list` | `arka quiz_practice list`       |

## Goal agent

Step budget के साथ autonomous multi-step tasks चलाएँ:

```bash theme={null}
arka goal set up a venv, install requests, and run pytest
arka goal -y -n 30 debug why nginx fails
```

Default step budget: `GOAL_MAX_STEPS=25`।

## Self-improve

Arka codebase का विश्लेषण और सुधार करें:

```bash theme={null}
arka self improve
arka self improve routing --apply
arka self memory
```

अगर आप चाहते हैं कि Arka एक phrase को route करे, तो पहले उसे `arka` के माध्यम से भेजें। सादी shell commands स्वचालित रूप से intercept नहीं होतीं।

देखें [Self-improve loop](/hi/guides/self-improve)।

## Operation modes

```bash theme={null}
arka mode debug    # routing और LLM traces दिखाएँ
arka mode agent    # default साफ़ output
arka mode list
```

देखें [Operation modes](/hi/guides/operation-modes)।

## Provider selection

```bash theme={null}
arka provider list
arka provider show
arka provider set gemini
arka provider set groq
arka provider set openrouter --refresh
arka provider set groq --no-keep-model
```

## Fish shell helpers

Fish उपयोग करते समय, ये functions उपलब्ध हैं:

```fish theme={null}
arka route "play bohemian rhapsody"   # routing preview करें
arka route # पिछला routing निर्णय
arka route # skill choice समझाएँ
```

## Config changes लागू करें

```bash theme={null}
arka reload              # .env + config.fish फिर से पढ़ें
arka reload --listen     # wake listener भी restart करें
```


## Related topics

- [Cursor और Claude के लिए MCP integration](/hi/guides/mcp.md)
- [Skills catalog: 70+ built-in Arka commands](/hi/guides/skills.md)
- [Quickstart: Arka इंस्टॉल करें और अपना पहला कमांड चलाएँ](/hi/quickstart.md)
- [Command aliases, subcommand synonyms, और skill नाम](/hi/reference/aliases.md)
- [Design references](/hi/guides/design-memory.md)