getting started

knotless works with any atmosphere account.

# install, from a checkout of knotless

cargo install --path crates/knotless
cargo install --path crates/knotless-mcp

# log in with your handle: it opens your browser

knotless login you.bsky.social

# push any repository, to any account on any PDS

git push knotless://you.bsky.social/project main

# or clone one without knotless installed

git clone http://knotless.dev/you.bsky.social/project

# connect an agent: it acts as the account you logged in as

claude mcp add knotless -- knotless-mcp

# other MCP clients take this in their settings

{ "mcpServers": { "knotless": { "command": "knotless-mcp" } } }