Docs Navigation

Semaphore CLI: Teams

  1. List all your teams
  2. Show information about a team
  3. Create a new team
  4. Change the name of the team
  5. Set the permission level of the team
  6. Removes a team from your organization
  7. List members of the team
  8. Add a user to the team
  9. Remove a user from the team
  10. List projects in a team
  11. Add a project to a team
  12. Remove a project from the team
  13. List secrets in a team
  14. Add secrets to a team
  15. Removes secrets from the team

List all your teams

$ sem teams:list

Examples:

$ sem teams:list
ID                                    NAME                 PERMISSION  MEMBERS
1bc7ed43-ac8a-487e-b488-c38bc757a034  renderedtext/devs    write       2 members
1bc7ed43-ac8a-487e-b488-c38bc757a034  renderedtext/admins  write       0 members

Show information about a team

$ sem teams:info TEAM_NAME

Examples:

$ sem teams:info renderedtext/admins
ID          1bc7ed43-ac8a-487e-b488-c38bc757a034
Name        renderedtext/admins
Permission  edit
Members     2 members
Created     2017-08-01 13:14:40 +0200
Updated     2017-08-02 13:14:40 +0200

Create a new team

$ sem teams:create TEAM_NAME
Flag Description
--permission Permission level of the team in the organization.
default: read

Examples:

$ sem teams:create renderedtext/interns
ID          1bc7ed43-ac8a-487e-b488-c38bc757a034
Name        renderedtext/interns
Permission  read
Members     0 members
Created     2017-08-01 13:14:40 +0200
Updated     2017-08-02 13:14:40 +0200

$ sem teams:create renderedtext/devs --permission edit
ID          1bc7ed43-ac8a-487e-b488-c38bc757a034
Name        renderedtext/devs
Permission  edit
Members     0 members
Created     2017-08-01 13:14:40 +0200
Updated     2017-08-02 13:14:40 +0200

$ sem teams:create renderedtext/admins --permission admin
ID          1bc7ed43-ac8a-487e-b488-c38bc757a034
Name        renderedtext/admins
Permission  admin
Members     0 members
Created     2017-08-01 13:14:40 +0200
Updated     2017-08-02 13:14:40 +0200

Change the name of the team

$ sem teams:rename OLD_TEAM_NAME NEW_TEAM_NAME

Examples:

$ sem teams:create renderedtext/interns renderedtext/juniors
ID          1bc7ed43-ac8a-487e-b488-c38bc757a034
Name        renderedtext/juniors
Permission  read
Members     0 members
Created     2017-08-01 13:14:40 +0200
Updated     2017-08-02 13:14:40 +0200

Set the permission level of the team

$ sem teams:set-permission TEAM_NAME --permission PERMISSION
Flag Description
--permission Permission level of the team in the organization.
required, default: read

Examples:

$ sem teams:set-permission renderedtext/interns --permission edit
ID          1bc7ed43-ac8a-487e-b488-c38bc757a034
Name        renderedtext/interns
Permission  edit
Members     0 members
Created     2017-08-01 13:14:40 +0200
Updated     2017-08-02 13:14:40 +0200

Removes a team from your organization

$ sem teams:delete TEAM_NAME

Examples:

$ sem teams:delete renderedtext/interns
Team renderedtext/interns deleted.

List members of the team

$ sem teams:members:list TEAM_NAME

Examples:

$ sem teams:members:list renderedtext/interns
NAME
shiroyasha
darko
ervinb

Add a user to the team

$ sem teams:members:add TEAM_NAME USERNAME

Examples:

$ sem teams:members:add renderedtext/interns shiroyasha
User shiroyasha added to the team.

Remove a user from the team

$ sem teams:members:remove TEAM_NAME USERNAME

Examples:

$ sem teams:members:remove renderedtext/interns shiroyasha
User shiroyasha removed from the team.

List projects in a team

$ sem teams:projects:list TEAM_NAME

Examples:

$ sem team:projects:list renderedtext/devs
NAME
ID                                    NAME
99c7ed43-ac8a-487e-b488-c38bc757a034  renderedtext/cli
12c7ed43-4444-487e-b488-c38bc757a034  renderedtext/api

Add a project to a team

$ sem teams:projects:add TEAM_NAME PROJECT_NAME

Examples:

$ sem team:projects:add renderedtext/devs renderedtext/cli
Project renderedtext/cli added to the team.

Remove a project from the team

$ sem teams:projects:remove TEAM_NAME PROJECT_NAME

Examples:

$ sem team:projects:remove renderedtext/devs renderedtext/cli
Project renderedtext/cli removed from the team.

List secrets in a team

$ sem teams:secrets:list TEAM_NAME

Examples:

$ sem team:secrets:list renderedtext/devs
ID                                    NAME                 CONFIG FILES  ENV VARS
99c7ed43-ac8a-487e-b488-c38bc757a034  renderedtext/tokens             1         0
1133ed43-ac8a-487e-b488-c38bc757a044  renderedtext/secrets            0         1

Add secrets to a team

$ sem teams:secrets:add TEAM_NAME SECRET_NAME

Examples:

$ sem team:secrets:add renderedtext/devs renderedtext/tokens
Secrets renderedtext/token added to the team.

Removes secrets from the team

$ sem teams:secrets:remove TEAM_NAME SECRET_NAME

Examples:

$ sem team:secrets:remove renderedtext/devs renderedtext/secrets
Secrets renderedtext/secrets removed from the team.

Semaphore Docs are open source — Edit on GitHub

Newsletter

Occasional lightweight product and blog updates. Unsubscribe at any time.

2009-2017 © Rendered Text. All rights reserved. Terms of Service, Privacy policy, Security.