# obsid.net

> Share Obsidian links that actually work in chat. obsid.net is a tiny URL redirect service that turns `https://obsid.net/?vault=<vault>&file=<file>` into a 308 redirect to `obsidian://open?vault=<vault>&file=<file>`, so messengers and tools that don't handle the `obsidian://` scheme can still serve clickable Obsidian deep links.

## Pages

- [Homepage](https://obsid.net/): Tool description, URL converter, and agent skill installation instructions.

## Endpoints

- `GET https://obsid.net/?vault={vault}&file={file}`: 308 redirect to `obsidian://open?vault={vault}&file={file}`. Both `vault` and `file` must be URL-encoded; backslashes in `file` are normalized to forward slashes by the client helper before encoding.

## Agent skill

The `obsid-link-builder` skill is published for agentic CLIs (Codex, OpenClaw, Claude Code) that need to emit canonical `obsid.net` URLs from a vault name and file path, or convert an existing `obsidian://open?...` URL into one.

- [SKILL.md](https://obsid.net/skills/obsid-link-builder/SKILL.md): Skill manifest with workflow and CLI invocation examples.
- [build_obsid_link.sh](https://obsid.net/skills/obsid-link-builder/scripts/build_obsid_link.sh): POSIX shell helper that normalizes input and prints the final `https://obsid.net/?vault=...&file=...` URL.

## Discovery

- [API catalog](https://obsid.net/.well-known/api-catalog): RFC 9727 linkset describing this service.
- [Sitemap](https://obsid.net/sitemap.xml)
- [robots.txt](https://obsid.net/robots.txt)