The GiiS CLI is a terminal interface for chatting with your GiiS agents and querying your knowledge base. Built with Go using Bubble Tea, it provides both an interactive TUI and non-interactive commands for scripting and automation.

Installation

Build from Source

Requires Go 1.26+.

git clone --depth 1 https://github.com/giis-ai/giis.git
cd giis/cli
go build -o giis-cli .
sudo mv giis-cli /usr/local/bin/

PyPI

Once a release is published, the CLI will also be installable as a Python package:

pip install giis-cli

Or with uv:

uv pip install giis-cli

Setup

On first launch, the interactive chat TUI walks you through setup automatically:

giis-cli chat

This prompts for your GiiS server URL and personal access token (PAT), tests the connection, and saves config to ~/.config/giis-cli/config.json (or $XDG_CONFIG_HOME/giis-cli/config.json if set). To reconfigure later, use the /configure command inside the TUI.

Generating an Access Token

Navigate to User Settings > Accounts & Access > New Access Token (/app/settings/accounts-access) to create an access token for the CLI.

Environment Variables

Environment variables override config file values. This is useful for CI/CD pipelines and scripting.

Variable	Required	Description
GIIS_SERVER_URL	No	Server URL (default: https://cloud.giis.app)
GIIS_PAT	No	Personal access token for authentication (required if no config file)
GIIS_PERSONA_ID	No	Default agent/persona ID
GIIS_STREAM_MARKDOWN	No	Enable/disable progressive markdown rendering (true/false)
GIIS_SSH_HOST_KEY	No	Path to SSH host key for the serve command

Validate Configuration

Verify that your configuration is correct and the server is reachable:

giis-cli validate-config

Commands

Command	Mode	Description
chat	Interactive	Launch the interactive chat TUI (requires terminal)
ask	Agent / Script	Ask a question and print the answer to stdout
agents	Agent / Script	List available agents (ID, name, description)
validate-config	Agent / Script	Check CLI configuration and server connectivity
install-skill	Agent / Script	Install the GiiS CLI agent skill file
experiments	Agent / Script	List experimental features and their status
serve	Interactive	Serve the GiiS TUI over SSH

Global Flags

Flag	Description
--version, -v	Print client and server version information
--debug	Run in debug mode (verbose logging)

Interactive Chat

giis-cli chat
giis-cli chat --no-stream-markdown

Opens a full-screen terminal UI for conversational interaction with your GiiS agents.

Flag	Description
--no-stream-markdown	Disable progressive markdown rendering during streaming

One-Shot Questions

Ask a question and get a response without entering the TUI:

giis-cli ask "What is our company's PTO policy?"

Use --agent-id to target a specific agent:

giis-cli ask --agent-id 5 "Summarize our Q4 roadmap"

Use --json for structured NDJSON output (useful for scripting):

giis-cli ask --json "List all active API integrations"

Flag	Description
--agent-id <int>	Agent ID to use (overrides default)
--json	Output NDJSON events instead of plain text
--prompt <string>	Question text (use with piped stdin context)
--quiet	Buffer output and print once at end
--max-output <int>	Max bytes before truncating (0 to disable)

List Agents

giis-cli agents
giis-cli agents --json

Prints a table of available agent IDs, names, and descriptions.

Serve over SSH

Share the interactive TUI over SSH — useful for accessing GiiS from a machine where you don't want to store credentials locally:

giis-cli serve --host 0.0.0.0 --port 2222

Clients can then connect and either paste a personal access token at the login prompt, or skip it by sending GIIS_PAT over SSH:

ssh your-host -p 2222

Slash Commands (Interactive TUI)

When using the interactive chat, the following slash commands are available:

Command	Description
/help	Show help message
/clear	Clear chat and start a new session
/agent	List and switch agents
/attach <path>	Attach a file to next message
/sessions	List recent chat sessions
/configure	Re-run connection setup
/connectors	Open connectors in browser
/settings	Open settings in browser
/quit	Exit GiiS CLI

Using as an AI Coding Assistant Skill

The GiiS CLI can be used as a tool by AI coding assistants (such as Claude Code and Cursor) to query your knowledge base directly from within your development environment.

Install the bundled skill file so your AI assistant can discover the CLI:

giis-cli install-skill
giis-cli install-skill --global
giis-cli install-skill --copy
giis-cli install-skill --agent claude-code

Flag	Description
--global, -g	Install to home directory instead of project
--copy	Copy files instead of symlinking
--agent, -a	Target specific agents (e.g. claude-code; can be repeated)

Once configured, the AI assistant can call giis-cli ask to look up company-specific information — policies, internal docs, connected data sources — without leaving the editor.

When the skill is invoked

The skill is triggered when you ask your AI assistant about:

• Company-specific information (policies, processes, documentation)
• Internal knowledge bases or connected data sources
• Anything referencing GiiS, "search GiiS", or querying company documents

It is not used for general programming questions or questions about code in the current repository.

Configuration for agents

If a human has already run giis-cli chat once (which includes first-time setup), the CLI works out of the box — AI assistants can invoke giis-cli ask directly with no additional setup.

Alternatively, you can configure via environment variables, which override the config file and are useful for CI/CD or sandboxed environments:

export GIIS_SERVER_URL="https://your-giis-server.com"
export GIIS_PAT="your-personal-access-token"

JSON output for structured parsing

Use --json to get NDJSON event output, which is easier for agents to parse programmatically:

giis-cli ask --json "List all active API integrations"

Event Type	Description
message_delta	Content token — concatenate all content fields for the full answer
stop	Stream complete
error	Error with error message field
search_tool_start	GiiS started searching documents
citation_info	Source citation with citation_number and document_id

Keyboard Shortcuts

Key	Action
Enter	Send message
Escape	Cancel current generation
Ctrl+O	Toggle source citations
Ctrl+D	Quit (press twice)
Scroll / Shift+Up/Down	Scroll chat history
Page Up / Page Down	Scroll half page