dotnet-ngql 2.0.1-preview.21

dotnet-ngql

Command-line tool for NGql — compiles a C# QueryBuilder snippet against NGql.Core and prints the rendered GraphQL.

Install

dotnet tool install -g dotnet-ngql

Update

dotnet tool update -g dotnet-ngql

The tool's version tracks NGql.Core in lockstep — installing a specific NGql version is --version 2.1.0.

Use

Render from a file:

ngql my-snippet.cs

Render from stdin:

cat my-snippet.cs | ngql
# or
echo 'QueryBuilder.CreateDefaultBuilder("Hello").AddField("world.name")' | ngql

A snippet is an expression-bodied C# script. The final expression must yield the builder whose ToString() will be printed. The tool automatically imports:

using System;
using System.Collections.Generic;
using System.Linq;
using NGql.Core;
using NGql.Core.Builders;

so a complete snippet can be as small as:

QueryBuilder.CreateDefaultBuilder("Hello")
    .AddField("world.name")

The output is plain GraphQL on stdout — composable with shell redirects:

ngql my-snippet.cs > out.graphql

Exit codes

When to use this

• Hand verification that a QueryBuilder snippet renders the GraphQL you expect.
• Companion tool for the NGql Claude Code skill, which generates NGql code from natural language or pasted GraphQL.
• Quick rendering inside CI scripts or git hooks (e.g. snapshotting expected query text).

License

MIT, same as NGql itself.