Team Management

Scitor uses GitHub’s own access controls to manage who can work on support tickets. There is no separate Scitor user list β€” if someone has the right level of access on your GitHub repository, they can use Scitor commands.

How access works

Slash commands run through GitHub Issues or Discussions. Who can do what is determined entirely by their GitHub repository role:

GitHub role What they can do in Scitor
Admin Everything β€” including billing and configuration commands
Write (Maintainer) Full command access β€” /send, /close, /label, /assign, etc.
Triage Can label, close, and reassign issues β€” but cannot use /send
Read Can view issues but cannot use any commands

The key distinction: /send requires Write access because it sends an email on behalf of your organisation. Triage-level collaborators can manage the queue but cannot reply to customers.

Adding a team member

  1. Open your support repository on GitHub
  2. Go to Settings β†’ Collaborators and teams
  3. Click Add people
  4. Search by GitHub username or email address
  5. Select the appropriate role β€” Write for agents who reply to customers, Triage for queue managers who only route and label
  6. Click Add [name] to this repository

GitHub emails the invitee. They must accept the invitation before they can access the repository.

Tip

For GitHub organisations, add a team (e.g. support-agents) to the repository rather than individual users. Onboarding and offboarding become one step: add or remove someone from the team.

Removing a team member

  1. Go to Settings β†’ Collaborators and teams in your support repository
  2. Click the Γ— next to the team member’s name
  3. Confirm removal

Access is revoked immediately. Issues they were assigned to remain assigned β€” use /assign @newperson on those issues to hand them off.

Recommended roles

Support agents β€” people who read tickets and reply to customers β€” need Write access. This allows:

  • /send β€” reply by email
  • /close, /reopen β€” manage ticket state
  • /label, /unlabel β€” apply labels
  • /assign, /followup, /schedule β€” route and manage
  • /analyze, /summarize, /generate-report β€” AI commands

Queue managers or leads β€” people who triage and route tickets but don’t reply directly β€” can use Triage. They can label, close, and reassign but cannot send outbound emails.

Observers or stakeholders β€” people who need visibility without acting on tickets β€” use Read.

Command permission reference

Command Minimum role
/send Write
/close, /reopen Triage
/label, /unlabel Triage
/assign, /unassign Triage
/followup, /schedule Write
/block-sender, /unblock-sender Write
/csat skip Write
/analyze, /summarize Write
/generate-report Write
/reply (saved replies) Write
/billing, /upgrade, /cancel Admin
/docs commands Admin
/authenticate-domain, /set-from-address Admin

If a collaborator uses a command above their access level, Scitor posts a comment explaining the required role.

Using GitHub Teams (organisations)

GitHub Teams are the cleanest way to manage support access at scale:

  1. Create a team in your GitHub organisation β€” e.g. support-agents
  2. Grant the team Write access to your support repository
  3. Add individuals to the team to give them access; remove them to revoke it

Repository permissions update immediately when team membership changes. No need to touch the repository settings directly.

Transferring ownership

If the person who installed Scitor leaves:

  • Billing via Stripe: update the billing email in the Stripe billing portal. The /billing command shows which provider manages your subscription.
  • Billing via GitHub Marketplace: GitHub’s billing is tied to the organisation account, not an individual user β€” no change needed.
  • GitHub App installation: the installation is linked to the organisation, not a person. Manage it at github.com/organizations/[your-org]/settings/installations.

As long as the repository and organisation remain active, Scitor continues working regardless of team changes.

Was this article helpful?

Scitor β€” Turn GitHub into your support platform