local-os-operator

Reads, searches, and writes local files for operational investigation of configs and logs.

3|1|Updated Feb 14, 2026
One-click install
npx skills add https://github.com/LiboMa/agenticops-chat --skill local-os-operator-liboma
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: local-os-operator
Source: https://github.com/LiboMa/agenticops-chat/tree/main/skills/local-os-operator
Command: npx skills add https://github.com/LiboMa/agenticops-chat --skill local-os-operator-liboma

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? Investigating infrastructure issues often requires reading local configuration files, tailing logs, and searching file contents, but doing this manually is slow and error-prone. This Skill gives an AI agent secure, structured access to local filesystem artifacts like Terraform files, Kubernetes manifests, nginx configs, and log files. ## Core Features & Use Cases - File Reading & Tailing: Read files with line numbers, offsets, and limits, or tail the last N lines of log files for rapid diagnosis. - Search & Discovery: Case-insensitive grep across files and recursive directory listing with pattern matching to locate configs and IaC templates. - Metadata & Writing: Inspect file size, permissions, and modification time, plus write or append text to files for operational output. - Security Model: System-level secrets (SSH keys, AWS credentials, .env files) are blocked by default, with an admin mode gated behind an environment variable. - Use Case: An agent investigating a 502 error can tail /var/log/nginx/error.log, search for the error pattern, read the nginx.conf, and verify file permissions before proposing a fix. ## Quick Start Ask the agent to tail the last 100 lines of /var/log/syslog and search for any error entries.

Frequently Asked Questions about local-os-operator

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

FAQPage Schema
How do I read and search local log files with an AI agent?▼

Use tail_local_file to read the last N lines of a log, or search_local_file for case-insensitive pattern matching with line numbers. For large files, read_local_file supports offset and limit parameters to read specific sections.

How to inspect Terraform and Kubernetes manifests locally?▼

Use list_local_directory with a pattern like *.tf or *.yaml and recursive=True to discover IaC files, then search_local_file to find specific resources or settings, and read_local_file to view full contents with line numbers.

Can the file tools access SSH keys or AWS credentials?▼

No, sensitive files like ~/.ssh/, ~/.aws/credentials, .env files, and system secrets such as /etc/shadow are blocked by default. Admin paths can be unlocked only by setting AIOPS_FILE_TOOLS_ADMIN_MODE=true for cluster management use cases.

Why is file output truncated when reading large files?▼

Output is truncated to 4000 characters for single files and 6000 characters for directory listings to prevent agent context overflow. Use offset and limit parameters on read_local_file to page through large files in sections.

What are the limitations of local filesystem access for agents?▼

The tools only access the local machine where the agent runs, not remote hosts. Sensitive paths remain blocked unless admin mode is enabled, and very large files must be read in chunks due to output truncation limits.