Docs

Sharing and visibility

Grixel gives each person access to the parts of the depot they need, and nothing else. This page explains what that looks like from your side as a user.

#You see what you've been granted

Your administrator grants you access to particular paths — a project, a team's area, a shared set of standards. Everywhere you look — listings, search, history, your AI assistant's view — you see only those paths.

#"Not found" can mean "not yours to see"

This is the one behavior worth understanding. If you try to reach a path you don't have access to, Grixel says not found — exactly what it would say if the path didn't exist at all.

grixel ls /companies/acme/games/unreleased-thing
# not found: /companies/acme/games/unreleased-thing

That's deliberate. Grixel doesn't say "access denied", because saying so would tell you the path exists. So:

  • If you get "not found" for something a colleague can see, you probably haven't been granted access — ask your administrator, don't assume it's a bug.
  • There's no way to tell, from the outside, whether a "not found" path is hidden or genuinely absent. That's the point.

#Check who you are

If something isn't visible and you expected it to be, confirm which account you're signed in as:

grixel whoami

#Private space that's just yours

You can carve out a private folder that only you (and administrators) can see, without asking anyone to set it up:

grixel private create scratch

Use it for work in progress you don't want visible to the team yet.

#Secrets that stay secret

For genuinely sensitive values — a .env, API keys — use encrypted secrets instead of a private folder. These are encrypted on your machine before they're stored, so even someone who can read the raw storage can't read them:

grixel key init                 # one-time: create your key
grixel secret add .env          # start protecting a file
grixel secret push              # upload the encrypted version
grixel secret pull              # bring it back on another machine

See the command reference for the full set.