|
Some checks are pending
Canary / Prepare Version (push) Waiting to run
Canary / build-acp (push) Blocked by required conditions
Canary / build-cli-linux (push) Blocked by required conditions
Canary / Upload Install Script (push) Waiting to run
Canary / bundle-macos-arm64 (push) Blocked by required conditions
Canary / bundle-macos-x64 (push) Blocked by required conditions
Canary / bundle-windows (push) Blocked by required conditions
Canary / bundle-windows-cuda (push) Blocked by required conditions
Canary / Release (push) Blocked by required conditions
Unused Dependencies / machete (push) Waiting to run
CI / changes (push) Waiting to run
CI / goose ACP npm packages (push) Blocked by required conditions
CI / Check Rust Code Format (push) Blocked by required conditions
CI / Build and Test Rust Project (push) Blocked by required conditions
CI / Build Lean ACP Binary (push) Blocked by required conditions
CI / Check and Test oi-kit Agent Crates on wasm32 (push) Blocked by required conditions
CI / Check oi-kit-bindings UniFFI (push) Blocked by required conditions
CI / Test Kotlin oi-kit package (push) Blocked by required conditions
CI / Build and Test TLS Backend (native-tls) (push) Blocked by required conditions
CI / Build and Test TLS Backend (rustls-tls) (push) Blocked by required conditions
CI / Build and Test Roaming Feature (push) Blocked by required conditions
CI / Build Rust Project on Windows (push) Waiting to run
CI / Check MSRV (push) Blocked by required conditions
CI / Lint Rust Code (push) Blocked by required conditions
CI / Check Generated Schemas are Up-to-Date (push) Blocked by required conditions
CI / Check oi-kit Release Configuration (push) Waiting to run
CI / Check oi-kit API Reference is Up-to-Date (push) Waiting to run
CI / Test and Lint Electron Desktop App (push) Blocked by required conditions
CI / Test Desktop Updater Install (ubuntu-latest) (push) Blocked by required conditions
CI / Test Desktop Updater Install (windows-latest) (push) Blocked by required conditions
MCP Conformance / Build Conformance Binaries (push) Waiting to run
MCP Conformance / Conformance 2025-11-25 / 0.1.16 (push) Blocked by required conditions
MCP Conformance / Conformance 2025-11-25 / 0.2.0-alpha.10 (push) Blocked by required conditions
MCP Conformance / Conformance 2026-07-28 / 0.2.0-alpha.10 (push) Blocked by required conditions
Create Minor Release PR / check-version-bump-pr (push) Waiting to run
Create Minor Release PR / release (push) Blocked by required conditions
Prepare oi-kit release / Create or update oi-kit release PR (push) Waiting to run
Live Provider Tests / check-fork (push) Waiting to run
Live Provider Tests / changes (push) Blocked by required conditions
Live Provider Tests / Build Binary (push) Blocked by required conditions
Live Provider Tests / Smoke Tests (push) Blocked by required conditions
Live Provider Tests / Smoke Tests (Code Execution) (push) Blocked by required conditions
Live Provider Tests / Compaction Tests (push) Blocked by required conditions
Publish Ask AI Bot Docker Image / docker (push) Waiting to run
Publish Docker Image / docker (push) Waiting to run
Scorecard supply-chain security / Scorecard analysis (push) Waiting to run
Co-authored-by: Filip Kujawa <filip.j.kujawa@gmail.com> |
||
|---|---|---|
| .blox | ||
| .cargo | ||
| .devcontainer | ||
| .github | ||
| .intersect | ||
| bin | ||
| buzz | ||
| crates | ||
| documentation | ||
| evals/harbor | ||
| examples | ||
| oidc-proxy | ||
| scripts | ||
| services/ask-ai-bot | ||
| ui | ||
| workflow_recipes/release_risk_check | ||
| .dockerignore | ||
| .gitattributes | ||
| .gitignore | ||
| .goosehints | ||
| AGENTS.md | ||
| BUILDING_DOCKER.md | ||
| BUILDING_LINUX.md | ||
| Cargo.lock | ||
| Cargo.toml | ||
| CLAUDE.md | ||
| clippy.toml | ||
| CODE_OF_CONDUCT.md | ||
| CONTRIBUTING.md | ||
| CUSTOM_DISTROS.md | ||
| deny.toml | ||
| Dockerfile | ||
| download_cli.ps1 | ||
| download_cli.sh | ||
| flake.lock | ||
| flake.nix | ||
| GOVERNANCE.md | ||
| I18N.md | ||
| Justfile | ||
| LICENSE | ||
| MAINTAINERS.md | ||
| MERGE_FIXES.md | ||
| README.md | ||
| release-plz.toml | ||
| RELEASE.md | ||
| RELEASE_CHECKLIST.md | ||
| RISCV_SETUP.md | ||
| rust-toolchain.toml | ||
| SECURITY.md | ||
| test_acp_client.py | ||
oi-kit provides the reusable Rust components for building agents. goose is a complete agent built with oi-kit: use its desktop app or CLI, or make it the agent backend for your own application over ACP.
Both live in this repository. goose is part of the Agentic AI Foundation (AAIF) at the Linux Foundation.
Build with oi-kit
Compose an agent from a state machine, operations, tools, model providers, and context management. Your application owns the interface, policies, and storage.
- Control how the agent works. Compose operations for tool execution, approvals, compaction, and your application's own behavior.
- Resume from saved state. Supply your own storage and let the state machine determine what to do next from the persisted conversation.
- Run in different environments. Use the core runtime in native applications, on servers, or in WebAssembly hosts.
- Run models in-process. Load supported local models directly, without Ollama or a separate inference server, with control over model loading and inference.
Rust exposes the full agent runtime. Python and Kotlin bindings currently cover model providers, streaming, and conversation compaction. oi-kit is in alpha; use the documentation version that matches your dependencies.
- Getting Started — build a small Rust agent with tools, streaming, and a saved conversation.
- Demos — explore working applications and their source code.
- Concepts — understand the state machine, operations, providers, and authentication.
- Reference — choose crates and find generated Rust, Python, and Kotlin API documentation.
Use goose
goose is a general-purpose agent for coding, research, writing, automation, and data analysis. Use the native desktop app on macOS, Linux, or Windows, or work from the terminal with the CLI. Connect tools and data through the Model Context Protocol (MCP).
Load local models directly inside goose, without a separate model server, or connect to over 85 providers, including Anthropic, OpenAI, Gemini, OpenRouter, and Amazon Bedrock.
Download the desktop app for macOS, Linux, and Windows.
Or install the CLI:
curl -fsSL https://github.com/aaif-goose/goose/releases/download/stable/download_cli.sh | bash
Then follow the goose Quickstart to configure a model and start a session.
Build an app over ACP
Use the pre-built goose binary as the agent behind your own application through the Agent Client Protocol (ACP). Start it as a subprocess:
goose acp
Your app sends prompts and receives streamed responses, tool activity, and permission requests. goose supplies the agent, model connections, tools, and saved conversations; your app owns the interface and workflow. This is also how goose Desktop talks to its backend.
Follow Build an app over ACP for a working client example, then consult the ACP extensions reference for goose-specific capabilities.
Quick links
- Quickstart
- Installation
- Tutorials
- Documentation
- Contributing
- Governance
- Custom Distributions — build your own goose distro with preconfigured providers, extensions, and branding