Skip to content

0.0.1

Latest

Choose a tag to compare

@vortezwohl vortezwohl released this 08 Jun 17:06
· 3 commits to main since this release

FileGlide 0.0.1

FileGlide 0.0.1 is a terminal-first filesystem toolkit built for both people and AI agents. It brings scoped path operations, file and directory traversal, precise text editing, binary-safe content handling, and explicit batch execution into one consistent command experience.

Whether you are managing local project trees, editing exact file ranges, handling multilingual content, or building agent-driven repository workflows, FileGlide helps you move from inspection to modification without falling back to fragile shell glue. The goal of 0.0.1 is simple: make filesystem automation more precise, more verifiable, and more practical for both humans and agents.

Why FileGlide

  • One unified command system for files, paths, trees, text, binary inspection, and batch execution
  • Scoped filesystem control through explicit roots instead of ad hoc shell path handling
  • Precise text editing with line-range replacement, anchor-based insertion, and controlled writes
  • Binary-safe workflows for byte inspection and raw payload handling without forced text decoding
  • Chinese-friendly and non-ASCII aware by design, with stronger handling for multilingual filenames and content
  • Agent-ready output with structured JSON responses for scripting, automation, and reproducible workflows

What’s in Version 0.0.1

FileGlide 0.0.1 delivers the first stable public foundation of the core product experience:

  • A consistent CLI for controlled filesystem operations
  • File, path, and mixed tree traversal commands with explicit root scoping
  • Text workflows for targeted reads, writes, grep, replace-lines, and insert-anchor editing
  • Binary workflows for safe byte inspection and binary writes
  • Cross-root move support for files and directories
  • Explicit batch execution for grouped filesystem plans
  • Initial agent skill support for Codex, Claude Code, and similar coding agents

Who It’s For

FileGlide is designed for:

  • Developers who want safer and more structured filesystem workflows in the terminal
  • AI-assisted coding workflows that need exact, machine-readable file operations
  • Repository automation tasks that require controlled edits instead of loose shell scripting
  • Multilingual environments where non-ASCII filenames and text handling matter
  • Users who want verifiable local file operations with predictable CLI responses

Product Positioning

FileGlide is not trying to be another generic shell wrapper. It focuses on one job: giving you practical filesystem access in a clean, scriptable, and agent-friendly form.

With version 0.0.1, FileGlide becomes a solid foundation for terminal-native file operations, precise repository editing, and constrained agent execution workflows.

Availability

FileGlide 0.0.1 is available as a Python package and requires Python 3.10+.

Install with:

pip install -U fileglide

or

uv add -U fileglide

FileGlide 0.0.1 是一个面向终端的文件系统工具,既为人类用户设计,也为 AI agents 而构建。它将受控路径操作、文件与目录遍历、精确文本编辑、二进制安全内容处理,以及显式批量执行,统一到一套一致的命令体验中。

无论你是在管理本地项目目录、修改精确文件区间、处理多语种内容,还是构建 agent 驱动的仓库工作流,FileGlide 都能帮助你从检查走到修改,而不必依赖脆弱的 shell 胶水逻辑。0.0.1 版本的目标很明确:让文件系统自动化更精确、更可验证,也更适合人和 agent 实际使用。

为什么选择 FileGlide

  • 统一的命令体系,覆盖文件、路径、树遍历、文本、字节检查和批量执行
  • 受控的文件系统范围,通过显式 root 约束路径,而不是依赖随意的 shell 路径处理
  • 精确文本编辑能力,支持按行替换、基于锚点插入,以及受控写入
  • 二进制安全工作流,支持字节检查和原始载荷写入,不会强行按文本解码
  • 天然适配中文和非 ASCII 场景,对多语种文件名和文本内容提供更强支持
  • 面向 agent 的结构化输出,支持 JSON 响应,便于脚本、自动化和可复现工作流

0.0.1 版本包含什么

FileGlide 0.0.1 提供了核心产品体验的首个稳定公开基础版本,重点包括:

  • 一套一致的受控文件系统 CLI 工作流
  • 带显式 root 作用域的文件、路径与混合树遍历命令
  • 面向精确读取、写入、grep、replace-lines 和 insert-anchor 的文本工作流
  • 面向安全字节检查与二进制写入的二进制工作流
  • 支持文件与目录的跨 root 移动
  • 用于成组文件系统操作的显式 batch 执行能力
  • 面向 Codex、Claude Code 等 coding agent 的初始 skill 支持

适用人群

FileGlide 面向以下用户:

  • 希望在终端中更安全、更结构化地操作文件系统的开发者
  • 需要精确、机器可读文件操作的 AI 辅助编码工作流
  • 希望以受控方式修改仓库文件而不是依赖零散 shell 脚本的自动化任务
  • 对中文、多语种内容和非 ASCII 文件名处理有要求的使用场景
  • 需要可验证、本地可控、响应稳定的文件操作工具的用户

产品定位

FileGlide 并不试图成为另一个泛用 shell 包装器。它专注做好一件事:以简洁、可脚本化、适合 agent 的方式,为你提供实用的文件系统访问能力。

在 0.0.1 版本中,FileGlide 已经成为一个适合终端原生文件操作、精确仓库编辑和受约束 agent 执行工作流的坚实基础。

获取方式

FileGlide 0.0.1 已作为 Python 包提供,要求 Python 3.10+

安装方式:

pip install -U fileglide

uv add -U fileglide