# Show HN: Skawld – Open-source SDK for company-specific AI agents

> Source: <https://github.com/skawld/skawld-sdk>
> Published: 2026-06-03 11:19:22+00:00

An open-source all-purpose TypeScript agent harness. Embed a full agent loop — tools, sessions, permissions, streaming events, subagents — into any Node.js or Bun application with a single import.

Runs on **Node.js 18+** and **Bun 1.1+**. ESM-only.

**Full documentation:** [https://skawld.com/docs](https://skawld.com/docs)

```
# pick your package manager
# Bun is reccomended
bun add @skawld/agent-sdk
# npm is also supported
npm install @skawld/agent-sdk
pnpm add @skawld/agent-sdk
yarn add @skawld/agent-sdk
js
import { Agent } from "@skawld/agent-sdk";
import { AnthropicProvider } from "@skawld/agent-sdk/providers";
import { defaultTools } from "@skawld/agent-sdk/tools";

const agent = new Agent({
  provider: new AnthropicProvider(),   // reads ANTHROPIC_API_KEY from env
  model: "claude-opus-4-5",
  tools: defaultTools(),
  permissions: { mode: "default" },
});

const session = await agent.session();

for await (const event of session.run("List the files in the current directory.")) {
  if (event.type === "assistant") {
    for (const block of event.message.content) {
      if (block.type === "text") process.stdout.write(block.text);
    }
  }
  if (event.type === "result") break;
}

await agent.close();
```

See [ examples/minimal-agent.ts](/skawld/skawld-sdk/blob/main/examples/minimal-agent.ts) for a complete runnable version.

[ examples/interactive-cli.ts](/skawld/skawld-sdk/blob/main/examples/interactive-cli.ts) is a small REPL that streams agent events, renders subagent activity in live boxes, and runs in

`yolo`

permission mode against the `OpenAIResponsesProvider`

.Setup:

```
export OPENAI_API_KEY=sk-...
# optional overrides
export SKAWLD_MODEL=gpt-5            # default: gpt-5
export SKAWLD_CONFIG_DIR=./.skawld   # default: ./.skawld
```

Run:

```
bun run examples/interactive-cli.ts
```

On startup it prompts for a working directory (defaults to the current one), then accepts free-form messages. Type `/exit`

or press `Ctrl+C`

to quit.

| Provider class | Subpath | Environment variable |
|---|---|---|
`AnthropicProvider` |
`@skawld/agent-sdk/providers` |
`ANTHROPIC_API_KEY` |
`OpenAIChatCompletionsProvider` |
`@skawld/agent-sdk/providers` |
`OPENAI_API_KEY` |
`OpenAIResponsesProvider` |
`@skawld/agent-sdk/providers` |
`OPENAI_API_KEY` |

``` js
import {
  AnthropicProvider,
  OpenAIChatCompletionsProvider,
  OpenAIResponsesProvider,
} from "@skawld/agent-sdk/providers";
```

| Variable | Used by |
|---|---|
`ANTHROPIC_API_KEY` |
`AnthropicProvider` (falls back to SDK default lookup) |
`OPENAI_API_KEY` |
`OpenAIChatCompletionsProvider` , `OpenAIResponsesProvider` |

By default, sessions persist to SQLite at `.skawld/sessions.db`

. For tests or embedded applications, pass a custom `sessionStore`

, such as `InMemorySessionStore`

.

``` js
import { Agent } from "@skawld/agent-sdk";
import { InMemorySessionStore } from "@skawld/agent-sdk/sessions";

const agent = new Agent({
  provider,
  model,
  sessionStore: new InMemorySessionStore(),
});
@skawld/agent-sdk             → Agent, Session, defaultTools, MCP helpers, core types, Event types, Error classes
@skawld/agent-sdk/providers   → AnthropicProvider, OpenAIChatCompletionsProvider, OpenAIResponsesProvider, BaseProvider
@skawld/agent-sdk/tools       → ToolRegistry, defaultTools, built-in tool classes, MCP tool helpers, task types
@skawld/agent-sdk/sessions    → SqliteSessionStore, InMemorySessionStore, SessionStore and task persistence types
@skawld/agent-sdk/permissions → PermissionEngine, permission callback types, permission rule types
```

MIT