vn projects

For users: the vn projects commands. Run team-owned projects and their rosters, and affiliate them with organizations. Every command accepts --json to print its result as JSON for scripts and agents. This page is generated from the CLI’s own oclif manifest on every build, so it matches the published @venturenetwork/cli. Install it from The CLI.

vn projects accept

Accept a pending affiliation that the other side asked for. Accepting for the organization also invites the team members who are not yet in it, unless you pass –no-invite-team. Nobody joins the org until they accept their own invitation.

vn projects accept AFFILIATION [flags]

Arguments

Argument	Required	Description
`AFFILIATION`	yes	Affiliation id, printed by vn projects affiliations and vn projects requests.

Flags

Flag	Type	Description	Default
`--invite-team`	boolean	When accepting for the organization, invite the team members who are not yet in it. `--no-invite-team` turns it off

Examples

vn projects accept 5d0c1a8e-2b7f-4c3d-8e9a-1f2b3c4d5e6f

vn projects accept 5d0c1a8e-2b7f-4c3d-8e9a-1f2b3c4d5e6f --no-invite-team

vn projects affiliate

Ask an organization to affiliate with your project. The org’s owners or admins accept or decline. The org has to be public or one you belong to. Leads and network admins only.

vn projects affiliate ID ORG [flags]

Arguments

Argument	Required	Description
`ID`	yes	Project id, printed by vn projects create, mine, and search.
`ORG`	yes	Slug of the organization to ask.

Flags

Flag	Type	Description	Default
`--kind`	option	community is a club or network, program an accelerator or cohort, investor a funder or stakeholder. one of `community`, `program`, `investor`. required
`--message`	option	A note to the organization, up to 500 characters.

Examples

vn projects affiliate 0b6f3c2e-7d1a-4f7e-9a51-3c2d8e4b9f10 gt-vn --kind program --message "Accepted into the fall cohort."

vn projects affiliations

List a project’s affiliations, newest first. The project’s leads and the org’s owners and admins see every status. Anyone else who can read the project sees active affiliations only.

vn projects affiliations ID [flags]

Arguments

Argument	Required	Description
`ID`	yes	Project id, printed by vn projects create, mine, and search.

Flags

Flag	Type	Description	Default
`--status`	option	Only list affiliations with this status. Left out, every status you can see. one of `pending`, `active`, `declined`, `cancelled`, `ended`
`--limit`	option	Maximum number of affiliations to read.	`25`
`--cursor`	option	Cursor from a previous page.

Examples

vn projects affiliations 0b6f3c2e-7d1a-4f7e-9a51-3c2d8e4b9f10

vn projects affiliations 0b6f3c2e-7d1a-4f7e-9a51-3c2d8e4b9f10 --status pending

vn projects assign

Put someone on a project’s roster, or change their role or title if they are already on it. Any active member with a profile can be assigned. Leads and network admins only.

vn projects assign ID HANDLE [flags]

Arguments

Argument	Required	Description
`ID`	yes	Project id, printed by vn projects create, mine, and search.
`HANDLE`	yes	Handle of the person.

Flags

Flag	Type	Description	Default
`--role`	option	Their role on the project. A new person defaults to member, and someone already on it keeps their role. one of `lead`, `member`
`--title`	option	A short title, for example Product. Up to 80 characters. Left out, an existing title is kept.

Examples

vn projects assign 0b6f3c2e-7d1a-4f7e-9a51-3c2d8e4b9f10 grace

vn projects assign 0b6f3c2e-7d1a-4f7e-9a51-3c2d8e4b9f10 grace --role lead --title Product

vn projects cancel

Cancel a pending affiliation that your side asked for. It stays as history.

vn projects cancel AFFILIATION

Arguments

Argument	Required	Description
`AFFILIATION`	yes	Affiliation id, printed by vn projects affiliations and vn projects requests.

Examples

vn projects cancel 5d0c1a8e-2b7f-4c3d-8e9a-1f2b3c4d5e6f

vn projects cohort

Set the cohort label on a pending or active affiliation, for example “Spring 2027”. Pass “” to clear it. Org owners and admins only.

vn projects cohort AFFILIATION LABEL

Arguments

Argument	Required	Description
`AFFILIATION`	yes	Affiliation id, printed by vn projects affiliations and vn projects requests.
`LABEL`	yes	The cohort label, up to 80 characters.

Examples

vn projects cohort 5d0c1a8e-2b7f-4c3d-8e9a-1f2b3c4d5e6f "Spring 2027"

vn projects create

Create a project. Your team owns it and you are seated as its lead. A project is addressed by its id, which this command prints.

vn projects create [flags]

Flags

Flag	Type	Description
`--name`	option	Project name, 2 to 80 characters. required
`--summary`	option	One-line summary, up to 280 characters.
`--description`	option	Longer description, up to 4000 characters.
`--stage`	option	Where the project is. one of `idea`, `validating`, `building`, `launched`
`--visibility`	option	network lets any signed-in member find it. private shows it only to its team and to the admins of affiliated orgs. one of `network`, `private`

Examples

vn projects create --name "Soil Sense"

vn projects create --name "Soil Sense" --stage validating --visibility private

vn projects decline

Decline a pending affiliation that the other side asked for. It stays as history, and a new request may follow it.

vn projects decline AFFILIATION

Arguments

Argument	Required	Description
`AFFILIATION`	yes	Affiliation id, printed by vn projects affiliations and vn projects requests.

Examples

vn projects decline 5d0c1a8e-2b7f-4c3d-8e9a-1f2b3c4d5e6f

vn projects delete

Delete a project, its roster, and its affiliation history. Leads and network admins only.

vn projects delete ID

Arguments

Argument	Required	Description
`ID`	yes	Project id, printed by vn projects create, mine, and search.

Examples

vn projects delete 0b6f3c2e-7d1a-4f7e-9a51-3c2d8e4b9f10

vn projects end

End an active affiliation. Either side may end it. It stays in the history of both, and org memberships and the roster do not change.

vn projects end AFFILIATION

Arguments

Argument	Required	Description
`AFFILIATION`	yes	Affiliation id, printed by vn projects affiliations and vn projects requests.

Examples

vn projects end 5d0c1a8e-2b7f-4c3d-8e9a-1f2b3c4d5e6f

vn projects invite

Invite a project to affiliate with your organization. The project’s leads accept or decline. Find a project with vn projects search. Org owners and admins only.

vn projects invite ORG ID [flags]

Arguments

Argument	Required	Description
`ORG`	yes	Slug of your organization.
`ID`	yes	Project id, printed by vn projects create, mine, and search.

Flags

Flag	Type	Description	Default
`--kind`	option	community is a club or network, program an accelerator or cohort, investor a funder or stakeholder. one of `community`, `program`, `investor`. required
`--message`	option	A note to the project’s leads, up to 500 characters.

Examples

vn projects invite gt-vn 0b6f3c2e-7d1a-4f7e-9a51-3c2d8e4b9f10 --kind community

vn projects invite-team

Invite a project’s team to your organization while the affiliation is active. Each roster member who is not in the org and has no pending invitation gets one, as a member. Nobody joins until they accept. Org owners and admins only.

vn projects invite-team AFFILIATION

Arguments

Argument	Required	Description
`AFFILIATION`	yes	Affiliation id, printed by vn projects affiliations and vn projects requests.

Examples

vn projects invite-team 5d0c1a8e-2b7f-4c3d-8e9a-1f2b3c4d5e6f

vn projects list

List the projects affiliated with an organization, with the kind and cohort of each affiliation. Only projects you can read show.

vn projects list ORG [flags]

Arguments

Argument	Required	Description
`ORG`	yes	Organization slug.

Flags

Flag	Type	Description	Default
`--status`	option	Which projects to list, by project status. one of `active`, `archived`, `all`	`active`
`--limit`	option	Maximum number of projects to list.	`25`
`--cursor`	option	Cursor from a previous page.

Examples

vn projects list gt-vn

vn projects list gt-vn --status all

vn projects mine

List the projects you are on, with the id each one is addressed by.

vn projects mine [flags]

Flags

Flag	Type	Description	Default
`--status`	option	Which projects to list. one of `active`, `archived`, `all`	`active`
`--limit`	option	Maximum number of projects to list.	`25`
`--cursor`	option	Cursor from a previous page.

Examples

vn projects mine

vn projects mine --status archived

vn projects requests

List an organization’s project affiliations, newest first, requests and invitations alike. Owners and admins see every status and how many of each team would be new to the org. Any other member sees active affiliations only.

vn projects requests ORG [flags]

Arguments

Argument	Required	Description
`ORG`	yes	Organization slug.

Flags

Flag	Type	Description	Default
`--status`	option	Only list affiliations with this status. Left out, every status you can see. one of `pending`, `active`, `declined`, `cancelled`, `ended`
`--limit`	option	Maximum number of affiliations to list.	`25`
`--cursor`	option	Cursor from a previous page.

Examples

vn projects requests gt-vn --status pending

vn projects requests gt-vn

vn projects search

Search network projects by name, newest first. Private projects never show here. Use it to find a project to invite with vn projects invite.

vn projects search QUERY [flags]

Arguments

Argument	Required	Description
`QUERY`	yes	Part of the project name.

Flags

Flag	Type	Description	Default
`--limit`	option	Maximum number of projects to list.	`25`
`--cursor`	option	Cursor from a previous page.

Examples

vn projects search soil

vn projects show

Show a project, its visibility, its active affiliations, and its roster.

vn projects show ID

Arguments

Argument	Required	Description
`ID`	yes	Project id, printed by vn projects create, mine, and search.

Examples

vn projects show 0b6f3c2e-7d1a-4f7e-9a51-3c2d8e4b9f10

vn projects terms

Print or set the private deal terms of an affiliation, such as a funding or stake arrangement. Only the project’s leads, network admins, and the org’s owners and admins can read or write them.

vn projects terms AFFILIATION [flags]

Arguments

Argument	Required	Description
`AFFILIATION`	yes	Affiliation id, printed by vn projects affiliations and vn projects requests.

Flags

Flag	Type	Description	Default
`--set`	option	Replace the terms with this text, up to 4000 characters. Pass “” to clear them.
`--file`	option	Replace the terms with the contents of this file, up to 4000 characters.

Examples

vn projects terms 5d0c1a8e-2b7f-4c3d-8e9a-1f2b3c4d5e6f

vn projects terms 5d0c1a8e-2b7f-4c3d-8e9a-1f2b3c4d5e6f --set "2% equity for the fall cohort"

vn projects terms 5d0c1a8e-2b7f-4c3d-8e9a-1f2b3c4d5e6f --file terms.md

vn projects unassign

Take someone off a project’s roster. Pass your own handle to leave the project. The last lead cannot leave or be removed.

vn projects unassign ID HANDLE

Arguments

Argument	Required	Description
`ID`	yes	Project id, printed by vn projects create, mine, and search.
`HANDLE`	yes	Handle of the person, or your own to leave.

Examples

vn projects unassign 0b6f3c2e-7d1a-4f7e-9a51-3c2d8e4b9f10 grace

vn projects update

Edit a project’s fields or visibility, or archive it with –status archived. Leads and network admins only.

vn projects update ID [flags]

Arguments

Argument	Required	Description
`ID`	yes	Project id, printed by vn projects create, mine, and search.

Flags

Flag	Type	Description
`--name`	option	Project name, 2 to 80 characters.
`--summary`	option	One-line summary, up to 280 characters.
`--description`	option	Longer description, up to 4000 characters.
`--stage`	option	Where the project is. one of `idea`, `validating`, `building`, `launched`
`--status`	option	Archive or reactivate the project. one of `active`, `archived`
`--visibility`	option	network lets any signed-in member find it. private shows it only to its team and to the admins of affiliated orgs. one of `network`, `private`

Examples

vn projects update 0b6f3c2e-7d1a-4f7e-9a51-3c2d8e4b9f10 --stage building

vn projects update 0b6f3c2e-7d1a-4f7e-9a51-3c2d8e4b9f10 --visibility private