> ## Documentation Index
> Fetch the complete documentation index at: https://docs.lyzr.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# Ways to Interact

> GitAgent meets you where you work: terminal, browser, chat app, or embedded directly in your own code.

<Note>
  **Building an app?** The SDK is the production entry point. Start with the [SDK Quick Start](/open-source/gitagent/sdk/quickstart) before reading anything else on this page.
</Note>

## SDK — Embed in Node.js

The production entry point. Import GitAgent directly into your Node.js application and call `query()` to send prompts programmatically.

```typescript theme={null}
// app.ts
import { query } from "@open-gitagent/gitagent";

for await (const msg of query({
  prompt: "Summarise yesterday's tasks",
  dir: "./my-agent",
})) {
  if (msg.type === "assistant") console.log(msg.content);
}
```

Links: [SDK Quick Start](/open-source/gitagent/sdk/quickstart) · [SDK Reference](/open-source/gitagent/sdk/overview)

## Personal Assistant

Run GitAgent as a local assistant with multiple ways to interact — terminal, browser, or messaging apps.

* **[CLI](/open-source/gitagent/personal-assistant/cli)** — Interactive terminal REPL — launch an agent session from your shell.
* **[Web & Voice](/open-source/gitagent/personal-assistant/web-voice)** — Full browser UI with chat, skills, scheduler, and real-time voice.
* **[Messaging](/open-source/gitagent/personal-assistant/messaging)** — Connect to Telegram, WhatsApp, or phone via Twilio.

See the [Personal Assistant Quick Start](/open-source/gitagent/personal-assistant/quickstart) to get running in minutes.

<CardGroup cols={2}>
  <Card title="SDK Quick Start" icon="rocket" href="/open-source/gitagent/sdk/quickstart">
    Install the SDK and call query() from your own Node.js app
  </Card>

  <Card title="Personal Assistant Quick Start" icon="terminal" href="/open-source/gitagent/personal-assistant/quickstart">
    Run GitAgent locally via CLI, browser, or messaging apps
  </Card>

  <Card title="Architecture" icon="folder-tree" href="/open-source/gitagent/architecture">
    The agent directory structure and agent.yaml schema
  </Card>

  <Card title="SDK Reference" icon="code" href="/open-source/gitagent/sdk/overview">
    Full query(), tool(), and hooks API reference
  </Card>
</CardGroup>