Condukt header

Hex.pm HexDocs CI Hex.pm downloads License

Condukt is an Elixir framework for building agents that do real work on your infrastructure.

Its source lives in condukt/ in the Tuist monorepo. It remains independently published as condukt on Hex.

The agent loop is the easy part of that and the least of what this gives you. Every session is a supervised process whose tools run in a sandbox, on a network you decide, with secrets it never gets to print:

Agents are the imperative half of the picture. They compose with a declarative workflow engine rather than replacing one: let the workflow own the steps you can name, and give an agent the ones you cannot.

Library

Use Condukt when agents should live inside your OTP system. Add it to mix.exs:

def deps do
  [
    {:condukt, "~> 1.5"}
  ]
end
defmodule MyApp.ProjectAgent do
  use Condukt

  @impl true
  def model, do: "anthropic:claude-sonnet-4-20250514"

  @impl true
  def system_prompt do
    "You help maintain this repository. Prefer concrete findings and patches."
  end

  @impl true
  def tools, do: Condukt.Tools.coding_tools()

  operation :release_notes,
    input: %{
      type: "object",
      properties: %{version: %{type: "string"}},
      required: ["version"]
    },
    output: %{
      type: "object",
      properties: %{
        title: %{type: "string"},
        highlights: %{type: "array", items: %{type: "string"}}
      },
      required: ["title", "highlights"]
    },
    instructions: "Draft release notes from the git history and project files."
end

Read the library documentation on HexDocs.

Repository layout

condukt/
├── lib/                  # Elixir library
├── native/               # Rust NIFs (bashkit, microsandbox, egress)
└── docs/guides/          # Library guides published with ExDoc

CI and releases live in the monorepo's .github/workflows/condukt*.yml.

Documentation

Library guides live in docs/guides/ and are published to HexDocs alongside the API reference.

License

The library and native code are MIT. See LICENSE. The library guides retain their MIT license.