ito-path

Generates absolute paths for project and worktree directories across environments.

Updated Mar 22, 2026
One-click install
npx skills add https://github.com/withakay/research --skill ito-path
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: ito-path
Source: https://github.com/withakay/research/tree/main/.opencode/skills/ito-path
Command: npx skills add https://github.com/withakay/research --skill ito-path

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes scripts (resource) components.

What problem does it solve?

Ensures consistent absolute paths for projects and worktrees across different environments, preventing the embedding of machine-specific paths in files.

Core Features & Use Cases

  • Absolute Path Resolution: Provides commands to generate stable paths for the project root, worktree root, .ito directory, and worktree directories.
  • Project Root Stability: Generates a stable root path across linked worktrees.
  • Use Case: Ideal for scripts and automated tasks that require project-wide paths, without the need to commit machine-specific details.

Quick Start

To find the project root, use the command: ito path project-root.

Frequently Asked Questions about ito-path

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

FAQPage Schema
How do I get absolute file paths for project scripts without embedding machine-specific details?

To get absolute file paths without machine-specific details, use a path resolution tool that generates stable project roots and worktree directories, ensuring cross-environment consistency. This prevents hardcoding local directories in your committed project scripts.

How does worktree management handle project root paths across different environments?

Worktree management resolves project root paths by generating stable absolute references that remain consistent across linked worktrees. This mechanism isolates directory structures from local machine configurations, maintaining script portability.

What is the best way to find the project root in a linked worktree?

The best way to find the project root in a linked worktree is executing a dedicated path command like `ito path project-root`. This directly outputs the stable, cross-environment root directory required for your automation tasks.

Can I use absolute path resolution for automated tasks across multiple worktree directories?

Yes, you can use absolute path resolution for automated tasks by requesting specific worktree directories. It provides commands to target the worktree root and `.ito` directory, enabling consistent script execution across environments.

Why does my script break when switching worktrees due to hardcoded absolute paths?

Scripts break when switching worktrees because hardcoded absolute paths contain machine-specific details that fail in new environments. Replacing them with dynamically resolved stable project paths ensures cross-environment consistency and prevents script portability issues.

Do I need dependencies to generate stable paths for project management in worktrees?

No, you do not need external dependencies to generate stable paths for project management in worktrees. The functionality operates independently through internal scripts to provide absolute paths for your project root and worktree directories.