Collaborators
Collaborators are the people you can share projects with. Think of it as your own contact list. You add someone by email, then grant them access to specific projects with es projects share. Removing a collaborator also revokes every project you'd shared with them.
Commands
| Command | What it does |
|---|---|
es collaborators add <email> |
Add someone to your collaborator list. |
es collaborators list |
List your collaborators (email, status, project count). |
es collaborators describe <email> |
Show a collaborator and the projects they can access. |
es collaborators remove <email> |
Remove a collaborator (revokes their access to your projects). |
es collab is an alias for es collaborators.
Active vs. pending
When you add someone:
- If they already have an Everscribe account, they're linked immediately and show up as active. You can share projects with them right away.
- If they don't, they get an email invite to create an account and show up as pending. Once they sign up they become active automatically.
You can only share a project with an active collaborator. Trying to share with a pending (or unknown) email returns a clear error telling you to add them or wait for them to sign up first.
Describe
es collaborators describe <email> prints the collaborator plus every project you've shared with them and their role on each. Defaults to YAML; pass --format table for a human-readable view or --format json for scripting.
es collaborators describe [email protected]
id: c_a1b2
email: [email protected]
username: teammate
status: active
projects:
- id: proj_123
name: production
role: editor
- id: proj_456
name: staging
role: viewer
Removing
es collaborators remove [email protected]
This deletes them from your collaborator list and revokes their access to any of your projects in one step so there's no need to es projects unshare first.