@agentskit/ink

@agentskit/ink

The public package entry is ESM-only because Ink 7 uses an ESM graph with top-level await.

Profile: concise-package

Build terminal AI chat interfaces on the shared AgentsKit controller contract.

Tags: ai · agents · llm · agentskit · ai-agents · terminal · cli · ink · tui · chat-ui

Verified proof

• Package metadata and tests live under packages/ink/.
• Package guide: https://www.agentskit.io/docs/reference/packages/ink
• Stability map: docs/STABILITY.md

How this fits the ecosystem

@agentskit/ink turns AgentsKit agents into polished terminal experiences for CLIs, internal tools, and developer workflows.

• AgentsKit: compose it with the other packages in this repo to build agents from small, swappable parts.
• Registry: look for ready agents and templates that already use this layer at registry.agentskit.io.
• Playbook: learn the production patterns behind this layer at playbook.agentskit.io.
• AKOS: run the same concepts with enterprise deployment, governance, and observability at akos.agentskit.io.

Docs: package guide · agent handoff

Why ink

• No context switching — if you know @agentskit/react, you already know this; same hooks, same component names, different renderer
• Real terminal UX — keyboard navigation, ANSI colors, and proper TTY streaming so your CLI feels native, not like a web app in a box
• Any local or cloud model — pair with Ollama for fully offline CLI tools, or any other provider via @agentskit/adapters
• Shared controller contract — tools, memory, and skills work across bindings; terminal components remain Ink-specific.

Install

npm install @agentskit/ink @agentskit/adapters

Quick example

import React from 'react'
import { render } from 'ink'
import { ChatContainer, InputBar, Message, useChat } from '@agentskit/ink'
import { ollama } from '@agentskit/adapters'

function App() {
  const chat = useChat({ adapter: ollama({ model: 'llama3.1' }) })
  return (
    <ChatContainer>
      {chat.messages.map(msg => <Message key={msg.id} message={msg} />)}
      <InputBar chat={chat} />
    </ChatContainer>
  )
}

render(<App />)

Features

• useChat hook — shared ChatReturn state/actions with terminal-specific components
• Terminal components: ChatContainer, Message, InputBar, ToolCallView
• Keyboard navigation and auto-scroll
• ANSI theming
• Memory is explicit — pass a ChatMemory when persistence is required

Ecosystem

Package	Role
@agentskit/react	Browser — same hooks, different renderer
@agentskit/cli	Interactive chat + agentskit init
@agentskit/adapters	Providers (e.g. ollama for local models)
@agentskit/core	Shared chat types and controller

Contributors

License

MIT — see LICENSE.

Docs

Full documentation · GitHub

Maturity and compatibility

• Stability: beta — see docs/STABILITY.md
• Node.js 20+ and TypeScript strict mode
• Published as @agentskit/ink

Contributing

See CONTRIBUTING.md and the monorepo LICENSE.