Skip to content
Closed
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension


Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
16 changes: 8 additions & 8 deletions Documentation.md
Original file line number Diff line number Diff line change
Expand Up @@ -163,8 +163,8 @@ description: A description of what this agent does
model:
preferred: "anthropic:claude-sonnet-4-6"
fallback:
- "openai:gpt-4o"
- "google:gemini-2.0-flash-001"
- "openai:gpt-4.1-mini"
- "google:gemini-2.5-flash"
constraints:
temperature: 0.7
max_tokens: 4096
Expand Down Expand Up @@ -202,7 +202,7 @@ dependencies:
# Sub-agents (optional)
agents:
researcher:
model: "anthropic:claude-haiku-4-5-20251001"
model: "anthropic:claude-haiku-4-5"
tools: [read, cli]

delegation:
Expand Down Expand Up @@ -263,11 +263,11 @@ GitAgent supports any model from the following providers out of the box:
| Provider | Format | API Key Env Var |
|----------|--------|-----------------|
| Anthropic | `anthropic:claude-sonnet-4-6` | `ANTHROPIC_API_KEY` |
| OpenAI | `openai:gpt-4o` | `OPENAI_API_KEY` |
| Google | `google:gemini-2.0-flash-001` | `GEMINI_API_KEY` |
| OpenAI | `openai:gpt-4.1-mini` | `OPENAI_API_KEY` |
| Google | `google:gemini-2.5-flash` | `GEMINI_API_KEY` |
| Groq | `groq:llama-3.3-70b-versatile` | `GROQ_API_KEY` |
| xAI | `xai:grok-2-1212` | `XAI_API_KEY` |
| Mistral | `mistral:mistral-large-latest` | `MISTRAL_API_KEY` |
| xAI | `xai:grok-3` | `XAI_API_KEY` |
| Mistral | `mistral:mistral-large-2512` | `MISTRAL_API_KEY` |
| OpenRouter | `openrouter:anthropic/claude-3.5-sonnet` | `OPENROUTER_API_KEY` |
| Cerebras | `cerebras:llama3.1-70b` | `CEREBRAS_API_KEY` |
| DeepSeek | `deepseek:deepseek-chat` | `DEEPSEEK_API_KEY` |
Expand Down Expand Up @@ -361,7 +361,7 @@ GitAgent supports real-time bidirectional voice via two adapters:

### Gemini Live

- Model: `gemini-2.0-flash`
- Model: `gemini-2.5-flash`
- Alternative voice provider
- Free tier available
- Requires: `GEMINI_API_KEY`
Expand Down
22 changes: 11 additions & 11 deletions README.md
Original file line number Diff line number Diff line change
Expand Up @@ -132,7 +132,7 @@ gitagent --repo https://github.com/org/repo "Add unit tests"
| `--repo <url>` | `-r` | GitHub repo URL to clone and work on |
| `--pat <token>` | | GitHub PAT (or set `GITHUB_TOKEN` / `GIT_TOKEN`) |
| `--session <branch>` | | Resume an existing session branch |
| `--model <provider:model>` | `-m` | Override model (e.g. `anthropic:claude-sonnet-4-5-20250929`) |
| `--model <provider:model>` | `-m` | Override model (e.g. `anthropic:claude-sonnet-4-6`) |
| `--sandbox` | `-s` | Run in sandbox VM |
| `--prompt <text>` | `-p` | Single-shot prompt (skip REPL) |
| `--env <name>` | `-e` | Environment config |
Expand All @@ -146,7 +146,7 @@ import { query } from "gitagent";
for await (const msg of query({
prompt: "List all TypeScript files and summarize them",
dir: "./my-agent",
model: "openai:gpt-4o-mini",
model: "openai:gpt-4.1-mini",
})) {
if (msg.type === "delta") process.stdout.write(msg.content);
if (msg.type === "assistant") console.log("\n\nDone.");
Expand All @@ -155,7 +155,7 @@ for await (const msg of query({
// Local repo mode via SDK
for await (const msg of query({
prompt: "Fix the login bug",
model: "openai:gpt-4o-mini",
model: "openai:gpt-4.1-mini",
repo: {
url: "https://github.com/org/repo",
token: process.env.GITHUB_TOKEN!,
Expand All @@ -179,7 +179,7 @@ import { query } from "gitagent";
for await (const msg of query({
prompt: "Refactor the auth module",
dir: "/path/to/agent",
model: "anthropic:claude-sonnet-4-5-20250929",
model: "anthropic:claude-sonnet-4-6",
})) {
switch (msg.type) {
case "delta": // streaming text chunk
Expand Down Expand Up @@ -336,8 +336,8 @@ version: 1.0.0
description: An agent that does things

model:
preferred: "anthropic:claude-sonnet-4-5-20250929"
fallback: ["openai:gpt-4o"]
preferred: "anthropic:claude-sonnet-4-6"
fallback: ["openai:gpt-4.1-mini"]
constraints:
temperature: 0.7
max_tokens: 4096
Expand Down Expand Up @@ -678,10 +678,10 @@ Gitagent works with any LLM provider supported by [pi-ai](https://github.com/bad
```yaml
# agent.yaml
model:
preferred: "anthropic:claude-sonnet-4-5-20250929"
preferred: "anthropic:claude-sonnet-4-6"
fallback:
- "openai:gpt-4o"
- "google:gemini-2.0-flash"
- "openai:gpt-4.1-mini"
- "google:gemini-2.5-flash"
```

Supported providers: `anthropic`, `openai`, `google`, `xai`, `groq`, `mistral`, and more.
Expand Down Expand Up @@ -861,15 +861,15 @@ export OPENAI_API_KEY="sk-..."
- Anthropic (Claude models via native SDK)
- Any OpenAI-compatible provider

Use `--model` flag to override: `gitagent --model anthropic:claude-sonnet-4-5-20250929`
Use `--model` flag to override: `gitagent --model anthropic:claude-sonnet-4-6`

### Core Concepts

**What is the SDK and how do I use it?**
The SDK provides programmatic access via `query()` function that streams agent events:
```typescript
import { query } from "gitagent";
for await (const msg of query({ prompt: "hello", model: "openai:gpt-4o-mini" })) {
for await (const msg of query({ prompt: "hello", model: "openai:gpt-4.1-mini" })) {
if (msg.type === "delta") process.stdout.write(msg.content);
}
```
Expand Down
22 changes: 11 additions & 11 deletions docs/firstsource-session.md
Original file line number Diff line number Diff line change
Expand Up @@ -176,7 +176,7 @@ description: First Source's GitAgent connected to Lyzr Studio
model:
preferred: "lyzr:agent-abc123xyz@https://agent-prod.studio.lyzr.ai/v4"
fallback:
- "openai:gpt-4o" # optional fallback if Studio is unreachable
- "openai:gpt-4.1-mini" # optional fallback if Studio is unreachable

tools:
- cli
Expand Down Expand Up @@ -237,10 +237,10 @@ description: Customer support agent for First Source

# Model configuration
model:
preferred: "anthropic:claude-sonnet-4-5-20250929"
preferred: "anthropic:claude-sonnet-4-6"
fallback:
- "openai:gpt-4o"
- "google:gemini-2.0-flash"
- "openai:gpt-4.1-mini"
- "google:gemini-2.5-flash"

# Built-in tools to enable
tools:
Expand Down Expand Up @@ -281,13 +281,13 @@ agents:

```yaml
# Anthropic
preferred: "anthropic:claude-sonnet-4-5-20250929"
preferred: "anthropic:claude-sonnet-4-6"

# OpenAI
preferred: "openai:gpt-4o"
preferred: "openai:gpt-4.1-mini"

# Google
preferred: "google:gemini-2.0-flash"
preferred: "google:gemini-2.5-flash"

# Groq (fast inference)
preferred: "groq:llama-3.3-70b-versatile"
Expand Down Expand Up @@ -1012,9 +1012,9 @@ version: 0.1.0
description: My First Source GitAgent

model:
preferred: "anthropic:claude-sonnet-4-5-20250929" # or your preferred provider
preferred: "anthropic:claude-sonnet-4-6" # or your preferred provider
fallback:
- "openai:gpt-4o"
- "openai:gpt-4.1-mini"

tools:
- cli
Expand Down Expand Up @@ -1129,7 +1129,7 @@ import { query } from "gitagent";
for await (const msg of query({
prompt: `Review PR #${process.env.PR_NUMBER} for security issues`,
dir: "./agent",
model: "anthropic:claude-sonnet-4-5-20250929",
model: "anthropic:claude-sonnet-4-6",
allowedTools: ["read", "cli"], // restrict for CI
})) {
if (msg.type === "assistant") console.log(msg.content);
Expand Down Expand Up @@ -1180,7 +1180,7 @@ npm install -g @open-gitagent/gitagent @open-gitagent/voice
# Run
gitagent "prompt" # run in current dir
gitagent --dir ~/my-agent "prompt" # specific dir
gitagent --model anthropic:claude-sonnet-4-5-20250929 "prompt" # override model
gitagent --model anthropic:claude-sonnet-4-6 "prompt" # override model
gitagent --voice # open web UI at localhost:3333
gitagent --sandbox "prompt" # run in isolated VM

Expand Down
4 changes: 2 additions & 2 deletions examples/local-repo.ts
Original file line number Diff line number Diff line change
Expand Up @@ -21,7 +21,7 @@ async function main() {

const stream = query({
prompt: "Read the README and summarize what this project does.",
model: "openai:gpt-4o-mini",
model: "openai:gpt-4.1-mini",
repo: {
url: REPO_URL,
token: TOKEN,
Expand Down Expand Up @@ -53,4 +53,4 @@ async function main() {
console.log("\nSession complete — changes committed and pushed to session branch.");
}

main().catch(console.error);
main().catch(console.error);
2 changes: 1 addition & 1 deletion examples/sdk-demo.ts
Original file line number Diff line number Diff line change
Expand Up @@ -12,7 +12,7 @@ async function main() {
for await (const msg of query({
prompt: "Use the greet tool to greet Zeus, then say something short and fun.",
dir: process.cwd(),
model: "openai:gpt-4o-mini",
model: "openai:gpt-4.1-mini",
tools: [greet],
hooks: {
preToolUse: async (ctx) => {
Expand Down
Loading