forge link

Link the current working directory to a project. Writes
.forge/link.json
.

Command

forge link [project-id]

Name	Type	Required	Notes
`project-id`	string	no	Project ID or slug; without args, lists projects

None.

Link to a project:

forge link my-app

List projects to choose from:

forge link
# → prj_xxx  my-app       ready   free
# → prj_yyy  another-app  ready   pro

Exit code	Meaning
0	Success
1	General error

No arguments — without a project ID, lists your accessible projects for selection.
Link file — writes the link to
```
.forge/link.json
```
in the current directory. Commands like
```
forge status
```
and
```
forge deploy
```
use this file to determine the target project.

{auto-injected}