dart_acp_opencode #

dart_acp_opencode finds the local OpenCode CLI, starts its built-in ACP server, and returns an initialized, typed dart_acp_sdk client connection.

Install #

dart pub add dart_acp_opencode

Install and authenticate the OpenCode CLI separately.

Quick start #

import 'dart:io';

import 'package:dart_acp_opencode/dart_acp_opencode.dart';

Future<void> main() async {
  final client = await OpenCodeAcpClient.start();
  try {
    final session = await client.agent
        .newSession(cwd: AcpAbsolutePath(Directory.current.path))
        .start();
    final result = await session
        .prompt(
          content: <ContentBlock>[
            ContentBlockText(TextContent(text: 'Summarize this project.')),
          ],
        )
        .collectText();
    print(result.text);
    session.dispose();
  } finally {
    await client.close();
  }
}

Configuration #

Pass OpenCodeAcpClientOptions to select an executable, working directory, environment, initialization timeout, shutdown timeout, and stderr observer. Discovery checks OPENCODE_EXECUTABLE, PATH, official install locations, and common package-manager locations on Windows, macOS, and Linux.

Pass your own AcpClientApp to OpenCodeAcpClient.start when the client should handle permission, file-system, terminal, or elicitation requests. The default client deliberately advertises none of those proxy capabilities and declines permission requests.

OpenCode is launched as opencode acp, using its native JSON-RPC-over-stdio ACP server.

This is an independent community package and is not built by or affiliated with the OpenCode team.

Testing #

Unit tests use deterministic fake processes. To also verify the installed CLI:

DART_ACP_LIVE_TESTS=true dart test test/live_integration_test.dart

Contributing #

See CONTRIBUTING.md.

License #

Licensed under the Apache License 2.0.