Skip to content

DotHarness/dotcraft

Repository files navigation

intro

中文 · Documentation · Getting Started · Download Release · DeepWiki · License

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

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.
  • Bring your own model: works with any OpenAI- or Anthropic-protocol provider, reuses an active ChatGPT subscription, and natively supports DeepSeek V4 and MiMo V2.5 reasoning models.

Highlights

DotCraft's capabilities, grouped by what they help you do.

Project-First Workspaces

Each project is its own workspace — running locally or on your own server.

Multi-Workspace — Every Project Gets Its Own Agent

DotCraft multi-workspace

Most agents reuse one setup across every project; DotCraft gives each project its own agent — its own conversations, memory, skills, plugins, and settings — so it truly understands what it's working on.

Learn more →

Remote Servers — Drive a Server-Hosted Agent from Desktop

DotCraft remote servers

Run DotCraft on your own server and connect from Desktop anytime to drive it remotely.

Learn more →

Agents That Keep Working

Hand off a goal or a mission, and DotCraft carries it forward.

Agent Profiles — Personalized Agents for Every Workflow

DotCraft Agent Profiles

Save purpose-built agents with their own model, tools, skills, and permissions. Pick one in a chat, assign it to a Team member, or bind it to an automation task so the right agent shows up where the work starts.

Learn more →

Agent Builder — Customize Your Agent by Chatting

DotCraft Agent Builder

Tell DotCraft what kind of agent you want, then refine its instructions, tools, skills, model, and approval style in a guided conversation.

Learn more →

Teams — Multi-agent Mission Board

DotCraft Teams

For a complex request, DotCraft assembles a small team to split up the work, dispatch it in parallel, and bring the results back together. You hand over one ask; you get the finished mission.

Learn more →

Goal — Persistent Conversation Objectives

DotCraft Goals

Pin a long-term goal to a conversation and give it a time or usage budget — whenever things go quiet, DotCraft quietly keeps working toward it. You decide when it pauses, resumes, or wraps up.

Learn more →

Thread Tools — The Agent Manages Its Own Conversations

DotCraft thread tools

From inside one conversation, DotCraft can look after all the others — start a new one in the background, search and read through past ones, pass a task along, or rename, pin, and tidy them away. It handles the housekeeping itself, without ever pulling you out of the conversation you're in.

Learn more →

Dreams — Background Memory Consolidation

Dreams review flow

While you work, Dreams quietly reviews recent activity in the background and drafts memory entries worth keeping. You approve them at your own pace, so the agent only remembers what you've actually agreed to.

Learn more →

Extend & Integrate

Bring your own tools, UIs, and services into the conversation.

Desktop Extensions — Plugins with a Full View Inside Desktop

DotCraft Desktop extensions

A plugin doesn't have to stop at adding tools — it can bring its own full interface right inside Desktop.

Learn more →

Interactive Tool Cards — Tool Results You Can Act On

DotCraft interactive tool cards

Some tool results are things you act on, not just read — a board to scan, an item to operate, a status to refresh. Those render as live, interactive cards in the conversation, where your clicks and inputs drive the agent.

Learn more →

App — SDK-driven App Binding for External Extensions

DotCraft App Binding

Have a service of your own? With the DotCraft SDK you can turn it into an App and plug it straight into the agent — its tools, data, and workflows become part of the conversation, with nothing extra in between.

Learn more →

Connect On Your Terms

Bring the agent to the chat apps you use, on the model you already pay for.

Cross Channels — One Agent Across Your Chat Apps Channel Handoff — Continue a Desktop Conversation in Chat
DotCraft Channels configuration and conversations DotCraft Channel Handoff
Run the same agent as a bot in QQ, WeCom, Feishu, Telegram, or WeChat — sharing one memory, skill set, and approval policy. Hand off a Desktop conversation to a connected social channel, then keep talking in the same thread.

Learn more →

ChatGPT Plan — Sign in with ChatGPT, No Extra API Costs

Sign in with ChatGPT

Already paying for ChatGPT Plus, Pro, Team, Business, or Enterprise? Sign in with your ChatGPT account and DotCraft will run on that subscription — no separate API key, no extra usage fees.

Learn more →

Get Started

Setup

  1. Download the desktop app from GitHub 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 for the full guided flow.

Documentation

Goal Document
Install, configure, and run DotCraft for the first time Getting Started
Use the graphical desktop client Desktop
Use the full terminal interface TUI
Run local automation tasks Automations & Hooks
Connect clients, bots, or custom adapters Channels & Bots
Deploy DotCraft and channel bots on a server Server Deployment
Architecture, SDKs, and protocols Architecture

Contributing

We welcome code, documentation, and integration contributions. Start with CONTRIBUTING.md.

Credits

Inspired by nanobot and codex, and built on agent-framework.

Special thanks to:

Articles

Technical articles related to dotcraft.

Why is your agent so expensive: Troubleshooting records of a 0% Prompt Cache hit rate.

License

Apache License 2.0

About

AI Agent lives in your project. Open-source, self-hosted, multi-provider, highly scalable, powered by .NET.

Topics

Resources

License

Contributing

Stars

Watchers

Forks

Packages

 
 
 

Contributors