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 TEAMNAME

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 TEAMNAME
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 OLDTEAMNAME NEWTEAMNAME

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 TEAMNAME --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 TEAMNAME

Examples:

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

# List members of the team

$ sem teams:members:list TEAMNAME

Examples:

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

# Add a user to the team

$ sem teams:members:add TEAMNAME 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 TEAMNAME USERNAME

Examples:

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

# List projects in a team

$ sem teams:projects:list TEAMNAME

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 TEAMNAME PROJECTNAME

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 TEAMNAME PROJECTNAME

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 TEAMNAME

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 TEAMNAME SECRETNAME

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 TEAMNAME 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-2018 © Rendered Text. All rights reserved. Terms of Service, Privacy policy, Security.