# Path Reference

> Create properly formatted references to paths (files or folders) in a git repository. Use when writing docs that need to link to any path in the repo. Use when this capability is needed.

- Skill: `tomevault-io/path-reference` (Agent Skill, multi-file: 2 files)
- Install (CLI): `npx skillmds@latest add tomevault-io/path-reference`
- Raw SKILL.md: https://api.skillmd.com/api/skills/tomevault-io/path-reference/raw
- Safety review: pending
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: Coding & Dev Tools
- Author: tomevault-io (https://skillmd.com/u/tomevault-io)
- Updated: 2026-09-17
- Page: https://skillmd.com/skills/tomevault-io/path-reference

---


# path-reference

Create clickable links to paths in a git repository.

## Commands

**Get web URL** (always use `-b default` for stable links):
```bash
uvx --from git-web-url==1.0.1 gwu url -p $path -b default
```

**Get relative path** (for display text):
```bash
uvx --from git-web-url==1.0.1 gwu relpath -p $path
```

## Link Formats

**Markdown:**
```markdown
[relative/path/to/file.py](https://github.com/user/repo/blob/main/relative/path/to/file.py)
```

**reStructuredText:**
```rst
`relative/path/to/file.py <https://github.com/user/repo/blob/main/relative/path/to/file.py>`_
```

## Supported Platforms

GitHub, GitLab, Bitbucket, AWS CodeCommit (including enterprise variants)

---
> Converted and distributed by [TomeVault](https://tomevault.io/claim/machu-gwu) — claim your Tome and manage your conversions.
<!-- tomevault:4.0:skill_md:2026-04-15 -->