@agentskit/ink — for agents

#Purpose

Ink binding for the ChatReturn contract from @agentskit/core. Renders a full chat interface in the terminal using React + Ink, with keyboard navigation, ANSI theming, and human-in-the-loop tool confirmation — no browser required.

#Install

npm install @agentskit/ink
# peers:
npm install react ink

#Primary exports

• useChat(config): ChatReturn — mirrors @agentskit/react.
• <ChatContainer>, <Message>, <InputBar>, <ToolCallView>, <ThinkingIndicator> — Ink components with keyboard nav + ANSI theming.
• <StatusHeader> — header strip showing provider / model / cost / status.
• <ToolConfirmation> — HITL approval prompt for risky tool calls.
• <MarkdownText> — render Markdown to Ink Text nodes.

#Minimal example

import { render } from 'ink'
import { ChatContainer } from '@agentskit/ink'
import { anthropic } from '@agentskit/adapters'

const adapter = anthropic({ apiKey: process.env.ANTHROPIC_KEY, model: 'claude-sonnet-4-6' })

render(<ChatContainer config={{ adapter }} />)

To use useChat directly and build a custom layout:

import { useEffect } from 'react'
import { render, Box, Text } from 'ink'
import { useChat } from '@agentskit/ink'
import { anthropic } from '@agentskit/adapters'

const adapter = anthropic({ apiKey: process.env.ANTHROPIC_KEY, model: 'claude-sonnet-4-6' })

function Chat() {
  const chat = useChat({ adapter })

  useEffect(() => {
    // cleanup: abort any in-flight stream when the component unmounts
    return () => chat.stop()
  }, [])

  return (
    <Box flexDirection="column">
      {chat.messages.map(m => <Text key={m.id}>{m.role}: {m.content}</Text>)}
    </Box>
  )
}

render(<Chat />)

#Common patterns

• Node only / TTY required: @agentskit/ink uses Ink which writes directly to process.stdout. It does not run in the browser or in non-TTY environments (e.g. piped CI output). Use @agentskit/react for browser targets.
• Peer deps on react and ink: both must be installed alongside @agentskit/ink — Ink requires React 18+ and does not bundle it.
• Cleanup via useEffect return: if you call useChat outside of <ChatContainer>, return chat.stop from a useEffect to abort in-flight streams when the component unmounts or the process exits.
• ANSI theming: pass a theme prop to <ChatContainer> or set CSS-variable-equivalent tokens via the theme config key to customise colours without forking components.

#Related

• @agentskit/core — ChatReturn contract.
• @agentskit/adapters — provider adapters.
• @agentskit/react, @agentskit/vue, @agentskit/svelte, @agentskit/solid, @agentskit/angular, @agentskit/react-native — sibling bindings.
• @agentskit/cli — agentskit chat ships Ink internally.

#Source

• npm: https://www.npmjs.com/package/@agentskit/ink
• repo: https://github.com/AgentsKit-io/agentskit/tree/main/packages/ink