llm-cli-setup

A CLI tool to set up developer tools and teach your AI coding assistants how to use them.

What This Does

Installs CLI tools: sqlcmd, GitHub CLI (gh), Atlassian CLI (atl), n8nctl, grafanactl, logcli, m365, esq, discordctl
Configures sqlcmd contexts: Named contexts for switching between database environments
Teaches your AI assistants: Injects CLI documentation into Claude Code, Gemini CLI, and Codex configs

Tool	Purpose
sqlcmd	Microsoft SQL Server command-line tool with context management
gh	GitHub CLI for PR/issue management
atl	Atlassian CLI for Jira/Confluence
n8nctl	n8n workflow automation CLI
grafanactl	Grafana CLI for dashboard/resource management
logcli	Loki CLI for querying Grafana Loki logs
m365	Microsoft 365 CLI for SharePoint/Teams/OneDrive management
esq	Elasticsearch Query CLI for cross-environment cluster queries
discordctl	Discord CLI for REST API interactions (messages, reactions)

Repository Overrides

Some tools install from other enthus-appdev repositories by default. To use your own forks instead, set these environment variables before running setup:

export ATL_CLI_REPO="your-org/atl-cli"           # Default: enthus-appdev/atl-cli
export N8N_CLI_REPO="your-org/n8n-cli"           # Default: enthus-appdev/n8n-cli
export ESQ_CLI_REPO="your-org/esq-cli"           # Default: enthus-appdev/esq-cli
export DISCORD_CLI_REPO="your-org/discordctl"    # Default: enthus-appdev/discordctl
export DISCORD_CLI_DIR="/path/to/discordctl"     # Default: ~/dev/discordctl

The Go-based tools (atl, n8nctl, esq) are installed via go install. discordctl is installed via npm link from a local clone.

Quick Start

git clone https://github.com/enthus-appdev/llm-cli-setup.git
cd llm-cli-setup
npm install
npm start

Usage

Interactive Mode (default)

llm-cli-setup

Shows a menu to configure individual tools or run full setup.

Command Line Options

llm-cli-setup --full    # Run full setup
llm-cli-setup --sql     # Configure SQL tools only
llm-cli-setup --gh      # Configure GitHub CLI only
llm-cli-setup --atl     # Configure Atlassian CLI only
llm-cli-setup --n8n     # Configure n8n CLI only
llm-cli-setup --grafana # Configure Grafana CLI only
llm-cli-setup --logcli  # Configure Loki CLI only
llm-cli-setup --m365    # Configure Microsoft 365 CLI only
llm-cli-setup --esq     # Configure Elasticsearch CLI only
llm-cli-setup --discord # Configure Discord CLI only
llm-cli-setup --llm     # Configure LLM tools only

Tools Configured

sqlcmd (SQL Server CLI)

Switch between database contexts with native sqlcmd config:

sqlcmd config current-context        # Show current context
sqlcmd config use-context <name>     # Switch context (e.g., sqlcmd config use-context dev)
sqlcmd config get-contexts           # List all configured contexts

Then run queries:

sqlcmd query "SELECT @@VERSION"
sqlcmd query -d MyDatabase "SELECT TOP 10 * FROM Users"

Adding contexts after setup: You can add new contexts anytime using the setup tool or manually edit ~/.sqlcmd/sqlconfig.

Config file: ~/.sqlcmd/sqlconfig (YAML format, managed by go-sqlcmd)

GitHub CLI (gh)

gh auth status                # Check authentication
gh pr list --author @me       # List your PRs
gh pr create --base main      # Create PR
gh issue view 123             # View issue

Atlassian CLI (atl)

Installs from enthus-appdev/atl-cli by default. Override with ATL_CLI_REPO env var if needed.

atl auth setup                # First-time OAuth setup (required once)
atl auth login                # Authenticate (opens browser)
atl issue view PROJ-1234      # View Jira issue
atl issue list --assignee @me # List your issues
atl confluence page search X  # Search Confluence

n8n CLI (n8nctl)

Installs from enthus-appdev/n8n-cli by default. Override with N8N_CLI_REPO env var if needed.

n8nctl config init            # Interactive setup
n8nctl config list            # List configured instances
n8nctl workflow list          # List workflows
n8nctl workflow pull <id>     # Download workflow to file
n8nctl workflow push file.json # Upload workflow
n8nctl workflow run <id> -w   # Execute and wait
n8nctl workflow run <id> --webhook <path>  # Trigger via webhook
n8nctl variable list          # List variables
n8nctl variable create k --value 'v'  # Create (--value avoids shell expansion)

Grafana CLI (grafanactl)

Requires Grafana 12+. Installs via go install or binary download.

grafanactl config check              # Verify configuration
grafanactl config use-context prod   # Switch context
grafanactl resources list            # List resource types
grafanactl resources get dashboards  # Get all dashboards
grafanactl resources pull dashboards -o ./dashboards/  # Backup
grafanactl resources push ./dashboards/                # Restore

Loki CLI (logcli)

Installs from grafana/loki GitHub releases.

# Set up environment variables
export LOKI_ADDR="<GRAFANA_URL>/api/datasources/proxy/<DATASOURCE_ID>"
export LOKI_BEARER_TOKEN="<GRAFANA_TOKEN>"

# Query logs
logcli labels k8s_deployment_name
logcli query '{k8s_deployment_name="myapp"}' --limit=20 --since=1h

Microsoft 365 CLI (m365)

Installs via npm from pnp/cli-microsoft365.

m365 login                        # Login with device code flow
m365 status                       # Check authentication status
m365 spo site list                # List SharePoint sites
m365 spo file list --webUrl <url> --folder "Shared Documents"

Elasticsearch Query CLI (esq)

Installs from enthus-appdev/esq-cli by default. Override with ESQ_CLI_REPO env var if needed.

esq config add prod --url <url>   # Add environment
esq config use prod               # Switch environment
esq search documents "query"      # Search with Lucene syntax
esq health                        # Cluster health

Discord CLI (discordctl)

Installs from enthus-appdev/discordctl by default via npm link from a local clone. Override with DISCORD_CLI_REPO and DISCORD_CLI_DIR env vars if needed.

discordctl config init                    # Interactive setup
discordctl msg list <channel>             # Read messages
discordctl msg send <channel> "text"      # Send a message
discordctl react add <channel> <id> 👍    # Add reaction

LLM Configuration

This tool teaches your AI coding assistants how to use these CLI tools by injecting documentation into their config files.

Supported AI Tools

AI Tool	Config Location
Claude Code	`~/.claude/CLAUDE.md`
Gemini CLI	`~/.gemini/GEMINI.md`
OpenAI Codex CLI	`~/.codex/CODEX.md`

How It Works

Reads existing config file (if any)
Injects CLI documentation between block markers: 
Preserves all your existing content outside the markers

The documentation includes:

Command syntax and examples for sqlcmd, gh, atl, n8nctl, grafanactl, logcli, m365, esq, and discordctl
Safety guidelines (e.g., confirm before SQL writes)
Formatting guides (Jira wiki markup, Confluence HTML)

Your existing configuration is safe - only content between the CLI Tools markers is modified.

Requirements

Node.js 18+
macOS or Linux (Windows not supported)
Package manager: Homebrew (macOS) or apt/dnf (Linux)

Project Structure

llm-cli-setup/
├── bin/
│   └── cli.js              # Main entry point
├── lib/
│   ├── index.js            # Library entry point (exports for environment-setup)
│   ├── installers/
│   │   ├── index.js        # Installer exports
│   │   ├── sqlcmd.js       # sqlcmd setup with context management
│   │   ├── gh.js           # GitHub CLI setup
│   │   ├── atl.js          # Atlassian CLI setup
│   │   ├── n8n.js          # n8n CLI setup
│   │   ├── grafanactl.js   # Grafana CLI setup
│   │   ├── logcli.js       # Loki CLI setup
│   │   ├── m365.js         # Microsoft 365 CLI setup
│   │   ├── esq.js          # Elasticsearch Query CLI setup
│   │   └── discord.js      # Discord CLI setup
│   ├── llm/
│   │   └── index.js        # LLM configuration with block markers
│   └── utils/
│       ├── platform.js     # Platform detection
│       └── shell.js        # Shell utilities
├── package.json
└── README.md

Development

npm install   # Install dependencies
npm start     # Run the CLI

Troubleshooting

atl installation fails

Make sure GitHub CLI is authenticated: gh auth login
Ensure you have access to the atl-cli repo (default: enthus-appdev/atl-cli)

atl auth fails

First-time users must run atl auth setup before atl auth login. This creates the OAuth app configuration.

Go binaries not in PATH

All Go-based tools (atl, n8nctl, grafanactl) install to ~/go/bin. Add to your shell profile:

export PATH="$PATH:$HOME/go/bin"

The setup tool will detect binaries in common locations even if not in PATH, but adding to PATH makes commands easier to use.

License

MIT

Name		Name	Last commit message	Last commit date
Latest commit History 84 Commits
.github		.github
bin		bin
lib		lib
.gitignore		.gitignore
.nvmrc		.nvmrc
.prettierignore		.prettierignore
.prettierrc		.prettierrc
CLAUDE.md		CLAUDE.md
CODE_OF_CONDUCT.md		CODE_OF_CONDUCT.md
CONTRIBUTING.md		CONTRIBUTING.md
LICENSE		LICENSE
README.md		README.md
SECURITY.md		SECURITY.md
eslint.config.js		eslint.config.js
package-lock.json		package-lock.json
package.json		package.json

Folders and files

Latest commit

History

Repository files navigation

llm-cli-setup

What This Does

Repository Overrides

Quick Start

Usage

Interactive Mode (default)

Command Line Options

Tools Configured

sqlcmd (SQL Server CLI)

GitHub CLI (gh)

Atlassian CLI (atl)

n8n CLI (n8nctl)

Grafana CLI (grafanactl)

Loki CLI (logcli)

Microsoft 365 CLI (m365)

Elasticsearch Query CLI (esq)

Discord CLI (discordctl)

LLM Configuration

Supported AI Tools

How It Works

Requirements

Project Structure

Development

Troubleshooting

atl installation fails

atl auth fails

Go binaries not in PATH

License

About

Topics

Resources

License

Code of conduct

Contributing

Security policy

Uh oh!

Stars

Watchers

Forks

Releases 4

Packages 0

Uh oh!

Uh oh!

Contributors

Uh oh!

Languages

Packages