HagiCode.Libs

HagiCode.Libs is a lightweight .NET 10 library workspace for reusable HagiCode CLI integrations and repository exploration.

Projects

src/HagiCode.Libs.Core - transport, process management, executable discovery, and runtime environment resolution.
src/HagiCode.Libs.Providers - provider abstractions, the Claude Code/Codex/CodeBuddy/Hermes/IFlow providers, and optional DI registration.
src/HagiCode.Libs.Exploration - Git repository discovery and state inspection.
tests/* - xUnit coverage for each project.

Getting started

cd repos/Hagicode.Libs
dotnet build HagiCode.Libs.sln
dotnet test HagiCode.Libs.sln

Dedicated provider console

src/HagiCode.Libs.ClaudeCode.Console, src/HagiCode.Libs.Codex.Console, src/HagiCode.Libs.Codebuddy.Console, src/HagiCode.Libs.Hermes.Console, and src/HagiCode.Libs.IFlow.Console are dedicated provider consoles built on the shared HagiCode.Libs.ConsoleTesting harness.

From repos/Hagicode.Libs, you can use:

dotnet run --project src/HagiCode.Libs.ClaudeCode.Console -- --help
dotnet run --project src/HagiCode.Libs.ClaudeCode.Console
dotnet run --project src/HagiCode.Libs.ClaudeCode.Console -- --test-provider
dotnet run --project src/HagiCode.Libs.ClaudeCode.Console -- --test-provider-full --repo .
dotnet run --project src/HagiCode.Libs.ClaudeCode.Console -- --test-all claude

dotnet run --project src/HagiCode.Libs.Codex.Console -- --help
dotnet run --project src/HagiCode.Libs.Codex.Console
dotnet run --project src/HagiCode.Libs.Codex.Console -- --test-provider codex-cli
dotnet run --project src/HagiCode.Libs.Codex.Console -- --test-provider-full --sandbox workspace-write --repo .
dotnet run --project src/HagiCode.Libs.Codex.Console -- --test-all codex

dotnet run --project src/HagiCode.Libs.Codebuddy.Console -- --help
dotnet run --project src/HagiCode.Libs.Codebuddy.Console
dotnet run --project src/HagiCode.Libs.Codebuddy.Console -- --test-provider codebuddy-cli
dotnet run --project src/HagiCode.Libs.Codebuddy.Console -- --test-provider-full --repo .
dotnet run --project src/HagiCode.Libs.Codebuddy.Console -- --test-all codebuddy

dotnet run --project src/HagiCode.Libs.Hermes.Console -- --help
dotnet run --project src/HagiCode.Libs.Hermes.Console
dotnet run --project src/HagiCode.Libs.Hermes.Console -- --test-provider hermes-cli
dotnet run --project src/HagiCode.Libs.Hermes.Console -- --test-provider-full --repo .
dotnet run --project src/HagiCode.Libs.Hermes.Console -- --test-provider-full --arguments "acp --profile smoke"
dotnet run --project src/HagiCode.Libs.Hermes.Console -- --test-all hermes

dotnet run --project src/HagiCode.Libs.IFlow.Console -- --help
dotnet run --project src/HagiCode.Libs.IFlow.Console
dotnet run --project src/HagiCode.Libs.IFlow.Console -- --test-provider iflow-cli
dotnet run --project src/HagiCode.Libs.IFlow.Console -- --test-provider-full --repo .
dotnet run --project src/HagiCode.Libs.IFlow.Console -- --test-provider-full --endpoint ws://127.0.0.1:7331/acp
dotnet run --project src/HagiCode.Libs.IFlow.Console -- --test-all iflow

No arguments run the default Claude suite.
默认套件当前包含 Ping、Simple Prompt、Complex Prompt 和 Session Restore。
--test-provider runs the provider ping flow for the Claude console only.
--test-provider-full and --test-all run the full provider-scoped suite.
--repo <path> adds the repository analysis scenario to the suite.
--api-key <key> and --model <model> override Claude execution options for scenario runs.
No arguments also run the default Codex suite.
Codex 默认套件当前包含 Ping、Simple Prompt、Complex Prompt 和 Session Resume。
Codex accepts --model <model>, --sandbox <mode>, --approval-policy <mode>, --api-key <key>, and --base-url <url> overrides.
Codex repository analysis remains opt-in via --repo <path> and reuses the same shared report formatter.
No arguments also run the default CodeBuddy suite.
CodeBuddy 默认套件当前包含 Ping、Simple Prompt、Complex Prompt 和 Session Resume。
CodeBuddy accepts --model <model> and defaults to glm-4.7 when no explicit model override is supplied.
CodeBuddy repository summary remains opt-in via --repo <path>.
No arguments also run the default Hermes suite.
Hermes 默认套件当前包含 Ping、Simple Prompt、Complex Prompt 和 Memory Reuse。
Hermes accepts --model <model>, --executable <path>, and --arguments <value> overrides.
Hermes repository summary remains opt-in via --repo <path>.
No arguments also run the default IFlow suite.
IFlow 默认套件当前包含 Ping、Simple Prompt、Complex Prompt 和 Session Resume。
IFlow accepts --model <model>, --endpoint <ws-url>, and --executable <path> overrides.
IFlow repository summary remains opt-in via --repo <path>.

Provider usage

The DI registration path now exposes all built-in providers:

using HagiCode.Libs.Providers;
using HagiCode.Libs.Providers.ClaudeCode;
using HagiCode.Libs.Providers.Codebuddy;
using HagiCode.Libs.Providers.Codex;
using HagiCode.Libs.Providers.Hermes;
using HagiCode.Libs.Providers.IFlow;
using Microsoft.Extensions.DependencyInjection;

var services = new ServiceCollection();
services.AddHagiCodeLibs();

await using var provider = services.BuildServiceProvider();
var claude = provider.GetRequiredService<ICliProvider<ClaudeCodeOptions>>();
var codebuddy = provider.GetRequiredService<ICliProvider<CodebuddyOptions>>();
var codex = provider.GetRequiredService<ICliProvider<CodexOptions>>();
var hermes = provider.GetRequiredService<ICliProvider<HermesOptions>>();
var iflow = provider.GetRequiredService<ICliProvider<IFlowOptions>>();

CodeBuddy execution options cover the ACP-specific runtime settings without forcing raw command lines:

var options = new CodebuddyOptions
{
    Model = "glm-4.7",
    WorkingDirectory = "/path/to/repo",
    EnvironmentVariables = new Dictionary<string, string?>
    {
        ["CODEBUDDY_TOKEN"] = "<token>"
    }
};

await foreach (var message in codebuddy.ExecuteAsync(options, "Reply with exactly the word 'pong'"))
{
    Console.WriteLine($"{message.Type}: {message.Content}");
}

Codex execution options cover the common CLI settings without forcing raw command lines:

var options = new CodexOptions
{
    Model = "gpt-5-codex",
    SandboxMode = "workspace-write",
    ApprovalPolicy = "never",
    WorkingDirectory = "/path/to/repo",
    AddDirectories = ["/path/to/repo"],
    SkipGitRepositoryCheck = true,
};

await foreach (var message in codex.ExecuteAsync(options, "Reply with exactly the word 'pong'"))
{
    Console.WriteLine(message.Type);
}

Hermes execution options cover the managed hermes acp bootstrap path without forcing raw process wiring. SessionId is treated as an in-memory conversation key for the current provider instance, rather than a cross-process resume token:

var options = new HermesOptions
{
    Model = "hermes/default",
    WorkingDirectory = "/path/to/repo",
    Arguments = ["acp"],
    EnvironmentVariables = new Dictionary<string, string?>
    {
        ["HERMES_TOKEN"] = "<token>"
    }
};

await foreach (var message in hermes.ExecuteAsync(options, "Reply with exactly the word 'pong'"))
{
    Console.WriteLine($"{message.Type}: {message.Content}");
}

IFlow execution options cover both managed bootstrap and explicit ACP endpoint reuse:

var options = new IFlowOptions
{
    Model = "iflow/default",
    WorkingDirectory = "/path/to/repo",
    Endpoint = new Uri("ws://127.0.0.1:7331/acp")
};

await foreach (var message in iflow.ExecuteAsync(options, "Reply with exactly the word 'pong'"))
{
    Console.WriteLine($"{message.Type}: {message.Content}");
}

If you want the provider to launch iflow for you, omit Endpoint and optionally set ExecutablePath. The managed path starts iflow --experimental-acp --port <allocated-port> and keeps the subprocess alive for the duration of the provider call.

Cross-platform CLI discovery validation

repos/Hagicode.Libs/.github/workflows/cli-discovery-cross-platform.yml runs real CLI discovery on ubuntu-latest, macos-latest, and windows-latest. The workflow uses CiSetup.Console to install all publicly available CLI tools and verify their availability on PATH, then runs provider-specific discovery tests for the installed CLIs.

CLI install registry

All CLI metadata is centralized in HagiCode.Libs.Core.Discovery.CliInstallRegistry. Each CliInstallDescriptor records the provider name, npm package, pinned version, executable candidates, and whether the CLI is publicly installable. This registry is the single source of truth — updating it automatically affects CI install/verify behavior.

Provider	npm Package	Pinned Version	CI-Covered
Claude Code	`@anthropic-ai/claude-code`	2.1.79	Yes
Codex	`@openai/codex`	0.115.0	Yes
CodeBuddy	(private)	—	No
Hermes	(private)	—	No
IFlow	(private)	—	No

CI-covered vs. locally-installed CLIs

CLIs with IsPubliclyInstallable = true are automatically installed and tested in CI. CLIs marked as not publicly installable (CodeBuddy, Hermes, IFlow) are skipped during CI setup and require local installation for validation.

Local reproduction

To reproduce the same real-CLI validation locally from the repos/Hagicode.Libs directory:

# Install and verify all publicly available CLIs
dotnet run --project src/HagiCode.Libs.CiSetup.Console -- --install --verify

# Run CI-targeted discovery tests (Claude Code + Codex only)
HAGICODE_REAL_CLI_TESTS=1 dotnet test tests/HagiCode.Libs.Providers.Tests/HagiCode.Libs.Providers.Tests.csproj --filter "FullyQualifiedName~ClaudeCodeProviderTests|FullyQualifiedName~CodexProviderTests" --logger "console;verbosity=normal"

The real-CLI path only checks executable discovery and the auth-free version ping behavior through the provider and dedicated console flows. It does not attempt interactive login or prompt execution, so the default test suite remains usable on machines without the external CLI installed.

Provider-specific local validation

Each provider can be validated individually when its CLI is available on PATH:

Claude Code:

HAGICODE_REAL_CLI_TESTS=1 dotnet test tests/HagiCode.Libs.Providers.Tests/HagiCode.Libs.Providers.Tests.csproj --filter "FullyQualifiedName~ClaudeCodeProviderTests"
HAGICODE_REAL_CLI_TESTS=1 dotnet test tests/HagiCode.Libs.ConsoleTesting.Tests/HagiCode.Libs.ConsoleTesting.Tests.csproj --filter "FullyQualifiedName~Claude"

Codex:

HAGICODE_REAL_CLI_TESTS=1 dotnet test tests/HagiCode.Libs.Providers.Tests/HagiCode.Libs.Providers.Tests.csproj --filter "FullyQualifiedName~CodexProviderTests"
HAGICODE_REAL_CLI_TESTS=1 dotnet test tests/HagiCode.Libs.ConsoleTesting.Tests/HagiCode.Libs.ConsoleTesting.Tests.csproj --filter "FullyQualifiedName~Codex"

CodeBuddy (requires local installation):

HAGICODE_REAL_CLI_TESTS=1 dotnet test tests/HagiCode.Libs.Providers.Tests/HagiCode.Libs.Providers.Tests.csproj --filter "FullyQualifiedName~Codebuddy"
HAGICODE_REAL_CLI_TESTS=1 dotnet test tests/HagiCode.Libs.ConsoleTesting.Tests/HagiCode.Libs.ConsoleTesting.Tests.csproj --filter "FullyQualifiedName~Codebuddy"

Hermes (requires local installation):

HAGICODE_REAL_CLI_TESTS=1 dotnet test tests/HagiCode.Libs.Providers.Tests/HagiCode.Libs.Providers.Tests.csproj --filter "FullyQualifiedName~Hermes"
HAGICODE_REAL_CLI_TESTS=1 dotnet test tests/HagiCode.Libs.ConsoleTesting.Tests/HagiCode.Libs.ConsoleTesting.Tests.csproj --filter "FullyQualifiedName~Hermes"

IFlow (requires local installation):

HAGICODE_REAL_CLI_TESTS=1 dotnet test tests/HagiCode.Libs.Providers.Tests/HagiCode.Libs.Providers.Tests.csproj --filter "FullyQualifiedName~IFlow"
HAGICODE_REAL_CLI_TESTS=1 dotnet test tests/HagiCode.Libs.ConsoleTesting.Tests/HagiCode.Libs.ConsoleTesting.Tests.csproj --filter "FullyQualifiedName~IFlow"

Design goals

Zero heavy framework dependencies in the reusable libraries.
Cross-platform CLI process management for Windows, macOS, and Linux.
Stream-oriented provider integrations that can power higher-level HagiCode tools.
Simple provider registration for DI and non-DI consumers.

Name		Name	Last commit message	Last commit date
Latest commit History 40 Commits
.github/workflows		.github/workflows
src		src
tests		tests
.gitignore		.gitignore
Directory.Build.props		Directory.Build.props
Directory.Packages.props		Directory.Packages.props
HagiCode.Libs.sln		HagiCode.Libs.sln
LICENSE		LICENSE
README.md		README.md
global.json		global.json

Provide feedback

Saved searches

Use saved searches to filter your results more quickly

Repository files navigation

HagiCode.Libs

Projects

Getting started

Dedicated provider console

Provider usage

Cross-platform CLI discovery validation

CLI install registry

CI-covered vs. locally-installed CLIs

Local reproduction

Provider-specific local validation

Design goals

About

Uh oh!

Releases

Packages

Uh oh!

Contributors

Uh oh!

Languages

Folders and files

Latest commit

History

Repository files navigation

HagiCode.Libs

Projects

Getting started

Dedicated provider console

Provider usage

Cross-platform CLI discovery validation

CLI install registry

CI-covered vs. locally-installed CLIs

Local reproduction

Provider-specific local validation

Design goals

About

Resources

License

Uh oh!

Stars

Watchers

Forks

Releases

Packages 0

Uh oh!

Contributors

Uh oh!

Languages

Packages