workspace
Linear workspace
Selects the stored workspace credentials used for this project.
Example: mycompanyProject configuration
Connect Linear CLI to the project you are building
Configure the current repository once so Linear CLI knows which workspace, team and version-control workflow to use. No information is submitted to LinearCli.com.
Run from the repository root
Create the project configuration
Current location
your-project/
Command
linear config
Saved result
.linear.toml
linear config
The CLI will guide you through the available project settings and write the selected values to a configuration file.
What the settings control
Choose defaults that match this repository
These values remove repeated choices from everyday issue commands.team_id
Default team
Tells issue commands which Linear team should be used by default.
Example: ENGvcs
Version control
Chooses the repository workflow used to detect the current issue.
Git or Jujutsuissue_sort
Issue sorting
Controls how issue lists are ordered when you work in the terminal.
Priority or manualGenerated project file
Understand what Linear CLI saves
Your selections are stored as readable TOML settings. The exact values depend on your own workspace and repository.
Keep secrets out of project configuration. Use the authenticated system keyring instead of placing an API key inside a repository file.
workspace = "mycompany"
team_id = "ENG"
vcs = "git"
issue_sort = "priority"Final check
Verify the configured team
List the unstarted issues assigned to you. A successful result confirms that authentication and project configuration work together.
linear issue mine
Your assigned issues should now appear in the terminal.
Configuration complete
Use the CLI in a real issue workflow
Learn how an issue becomes a branch and then a pull request.LinearCli.com is an independent documentation reference and does not receive your workspace, configuration or API credentials.