<div align="center">

![intro](https://github.com/DotHarness/resources/raw/master/dotcraft/intro.png)

[中文](./README_ZH.md) · [Documentation](https://dotharness.github.io/dotcraft/) · [Getting Started](https://dotharness.github.io/dotcraft/getting-started) · [Download Release](https://github.com/DotHarness/dotcraft/releases) · [DeepWiki](https://deepwiki.com/DotHarness/dotcraft) · [License](./LICENSE)

AI Agent lives in your project. All in one workspace.

</div>

## About

DotCraft is a .NET 10 / C# Agent Harness. It organizes AI workflows around a real project folder, allowing multiple entry points to share one session core, configuration, skills, tools, tasks, and observability surface.

- Project first: plugins, skills, sessions, and memory are integrated with the project, the agent can better understand your project.
- Unified session model: CLI, Desktop, TUI, chatbots, etc, all applications reuse the same execution engine.
- Observability and governance: approvals, traces, Dashboard, Hooks, and sandbox settings make agent workflows easier to inspect and control.
- Extensibility and integration: AppServer, SDKs, and plugins support custom entry points and business workflows.

## Get Started

![Setup](https://github.com/DotHarness/resources/raw/master/dotcraft/setup.png)

1. Download the desktop app from [GitHub Releases](https://github.com/DotHarness/dotcraft/releases).
2. Choose a real project folder as your workspace.
3. Follow the initialization guide to configure the workspace and model provider.
4. Create a session and send your first repository-understanding request.

See [Getting Started](https://dotharness.github.io/dotcraft/getting-started) for the full guided flow.

## Documentation

| Goal | Document |
|------|----------|
| Install, configure, and run DotCraft for the first time | [Getting Started](https://dotharness.github.io/dotcraft/getting-started) |
| Use the graphical desktop client | [Desktop](https://dotharness.github.io/dotcraft/features/entry-points/desktop) |
| Use the full terminal interface | [TUI](https://dotharness.github.io/dotcraft/features/entry-points/tui) |
| Run local automation tasks | [Automations & Hooks](https://dotharness.github.io/dotcraft/features/automations) |
| Connect clients, bots, or custom adapters | [Channels & Bots](https://dotharness.github.io/dotcraft/features/entry-points/channels) |
| Architecture, SDKs, and protocols | [Architecture](https://dotharness.github.io/dotcraft/developing/architecture) |

## Contributing

We welcome code, documentation, and integration contributions. Start with [CONTRIBUTING.md](./CONTRIBUTING.md).

## Credits

Inspired by [nanobot](https://github.com/HKUDS/nanobot) and [codex](https://github.com/openai/codex), and built on [agent-framework](https://github.com/microsoft/agent-framework).

Special thanks to:

- [HKUDS/nanobot](https://github.com/HKUDS/nanobot)
- [openai/codex](https://github.com/openai/codex)
- [microsoft/agent-framework](https://github.com/microsoft/agent-framework)
- [alibaba/OpenSandbox](https://github.com/alibaba/OpenSandbox)
- [modelcontextprotocol/csharp-sdk](https://github.com/modelcontextprotocol/csharp-sdk)
- [openai/symphony](https://github.com/openai/symphony)
- [router-for-me/CLIProxyAPI](https://github.com/router-for-me/CLIProxyAPI)

## License

Apache License 2.0
