cli-tools-agent-setup

Diagnose and configure CLI availability and authentication for Hermes agent profiles.

5|Updated Jun 3, 2026
One-click install
npx skills add https://github.com/rafael-fae/agent-ops-worflow --skill cli-tools-agent-setup
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: cli-tools-agent-setup
Source: https://github.com/rafael-fae/agent-ops-worflow/tree/main/skills/operacao/cli-tools-agent-setup
Command: npx skills add https://github.com/rafael-fae/agent-ops-worflow --skill cli-tools-agent-setup

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve?

This Skill solves the friction of making external command-line tools available and reliable inside Hermes agent profiles, especially when a CLI works for the human operator but fails inside isolated agent home directories.

Core Features & Use Cases

  • Cross-profile CLI setup: Explains how to make Gemini, Claude Code, and OpenCode accessible across separate agent HOME environments.
  • Environment-specific diagnosis: Helps identify whether a tool is installed on Mac local, OVH server, or both, and clarifies which path and auth method applies in each place.
  • Model and provider governance: Enforces the approved engine hierarchy, including the rule that code generation must use Claude Opus, Gemini 3.1 Pro, or OpenCode GLM 5.1, and warns against misattributing model provenance.
  • Operational troubleshooting: Covers common failures such as isolated credentials, broken symlinks, TUI-only behavior, background-mode issues, and partial binary corruption.
  • Use Case: A team member installs Gemini on the server, but agent tasks cannot see it until the correct HOME, credentials, and symlinks are configured for each profile.

Quick Start

Ask the skill to diagnose which of the three approved CLIs is available in the target Hermes environment and to tell you the exact setup needed for agent access.

Frequently Asked Questions about cli-tools-agent-setup

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I make Claude Code available inside an isolated agent HOME directory?

Configuring Claude Code for isolated agent HOME directories requires setting up the correct credentials and symlinks for each profile so the tool is accessible across separate environments where the human operator installed it.

Why does Gemini CLI work in my terminal but fail inside agent profiles?

Gemini CLI fails inside agent profiles because isolated home directories cannot access the user-level credentials or binary paths. You must configure environment-specific HOME settings and authentication for each agent profile to restore access.

What's the best way to configure multiple CLI tools for cross-profile agent workflows?

The best way to configure multiple CLI tools for cross-profile agent workflows is to diagnose which approved CLIs are installed on your target environments, then apply the correct symlinks and authentication methods for each agent profile.

Can I use OpenCode and Gemini CLI together on both Mac and OVH servers?

You can use OpenCode and Gemini CLI on both Mac and OVH servers by identifying the environment-specific execution paths and applying the correct authentication method for each platform to ensure deterministic setup for agent workflows.

How do I fix CLI tool failures caused by broken symlinks or partial binary corruption?

Fixing CLI tool failures from broken symlinks or partial binary corruption requires diagnosing the environment-specific installation path, repairing the symlinks for the isolated agent profile, and reconfiguring the authentication method.

When do I need to enforce model attribution honesty for code generation CLIs?

You need to enforce model attribution honesty for code generation CLIs whenever running batch or TUI execution constraints, ensuring tasks use the approved engine hierarchy like Claude Opus or Gemini 3.1 Pro and correctly reporting model provenance.